> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Récupérer les numéros de téléphone disponibles

> Récupérer tous les numéros de téléphone disponibles pour l’attribution à un assistant

<Warning>
  **API Famulor 1.0 (héritée).** Cette page concerne uniquement Famulor 1.0 (`app.famulor.de`) et est conservée pour la compatibilité. Pour la plateforme actuelle, consultez la [référence API Famulor 2.0](/fr/api-reference/introduction).
</Warning>

Ce point de terminaison renvoie la liste des numéros de téléphone appartenant à l’utilisateur authentifié qui peuvent être attribués à des assistants, avec un filtrage optionnel par type d’assistant.

### Paramètres de requête

<ParamField query="type" type="string">
  Filtrer les numéros de téléphone par type d’assistant. Options : `inbound`, `outbound`
</ParamField>

### Champs de réponse

L’API renvoie un tableau direct de numéros de téléphone disponibles :

<ResponseField name="array" type="array">
  Tableau des numéros de téléphone disponibles

  <Expandable title="Propriétés du numéro de téléphone">
    <ResponseField name="id" type="integer">
      L’identifiant unique du numéro de téléphone
    </ResponseField>

    <ResponseField name="phone_number" type="string">
      Le numéro de téléphone au format E.164
    </ResponseField>

    <ResponseField name="country_code" type="string">
      Le code pays du numéro de téléphone
    </ResponseField>

    <ResponseField name="type_label" type="string">
      Le libellé lisible indiquant le type du numéro de téléphone
    </ResponseField>

    <ResponseField name="is_available" type="boolean">
      Indique si le numéro de téléphone est disponible pour attribution (non actuellement attribué à un assistant entrant)
    </ResponseField>
  </Expandable>
</ResponseField>

### Remarques

* Seuls les numéros de téléphone appartenant à l’utilisateur authentifié sont renvoyés
* Lorsque `type=inbound` est spécifié, les numéros d’identifiant d’appelant et les numéros déjà attribués sont exclus
* Le champ `is_available` indique si le numéro peut être attribué à un nouvel assistant entrant
* Les numéros de téléphone sont renvoyés au format d’une collection de valeurs (tableau indexé)
* Utilisez le champ `id` lors de l’attribution de numéros de téléphone à des assistants

<ResponseExample>
  ```json 200 Response theme={null}
  [
    {
      "id": 2103,
      "phone_number": "+491748236179",
      "country_code": "DE",
      "type_label": "Caller ID",
      "is_available": true
    },
    {
      "id": 2131,
      "phone_number": "+4915792613301",
      "country_code": "DE",
      "type_label": "Caller ID",
      "is_available": true
    }
  ]
  ```

  ```json Inbound-only available numbers theme={null}
  [
    {
      "id": 2103,
      "phone_number": "+491748236179",
      "country_code": "DE",
      "type_label": "Caller ID",
      "is_available": true
    },
    {
      "id": 2131,
      "phone_number": "+4915792613301",
      "country_code": "DE",
      "type_label": "Caller ID",
      "is_available": true
    }
  ]
  ```
</ResponseExample>

<Tip>
  Pages associées : [Introduction](/fr/api-v1/introduction) et [Guide d’authentification](/fr/api-v1/authentication), et [Exemples d’intégration API](/fr/api-v1/introduction).
</Tip>