> ## 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.

# Lister les numéros de téléphone

> Récupère tous les numéros de téléphone de l'utilisateur authentifié

<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 de tous les numéros de téléphone liés à votre compte, y compris leur statut d'abonnement et leurs capacités.

<Note>
  Il existe aussi un point de terminaison hérité `GET /user/phone-numbers` qui ne renvoie que les numéros de téléphone compatibles SMS avec un abonnement actif. Utilisez ce point de terminaison `/all` lorsque vous avez besoin de tous les numéros de téléphone, quel que soit leur compatibilité SMS ou le statut de leur abonnement.
</Note>

### Champs de réponse

<ResponseField name="data" type="array">
  Tableau d'objets numéro de téléphone

  <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 (par ex. +49155551234)
    </ResponseField>

    <ResponseField name="nickname" type="string">
      Une courte étiquette conviviale pour le numéro (ou `null` si non définie)
    </ResponseField>

    <ResponseField name="country_code" type="string">
      Le code pays ISO 3166-1 alpha-2 (par ex. DE, GB, AU)
    </ResponseField>

    <ResponseField name="type" type="string">
      Le type de numéro de téléphone : `normal`, `sip` ou `caller_id`
    </ResponseField>

    <ResponseField name="type_label" type="string">
      Étiquette lisible pour le type de numéro de téléphone
    </ResponseField>

    <ResponseField name="sms_capable" type="boolean">
      Indique si le numéro de téléphone peut envoyer et recevoir des SMS
    </ResponseField>

    <ResponseField name="region" type="string">
      La région dans laquelle le numéro de téléphone a été provisionné
    </ResponseField>

    <ResponseField name="has_active_subscription" type="boolean">
      Indique si le numéro de téléphone a un abonnement actif
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Horodatage ISO 8601 de l'achat du numéro de téléphone
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 Success theme={null}
  {
    "data": [
      {
        "id": 1,
        "phone_number": "+49155551234",
        "nickname": "Sales line",
        "country_code": "DE",
        "type": "normal",
        "type_label": "Dedicated Number",
        "sms_capable": true,
        "region": "us1",
        "has_active_subscription": true,
        "created_at": "2025-01-07T10:30:00.000000Z"
      },
      {
        "id": 2,
        "phone_number": "+442071234567",
        "nickname": null,
        "country_code": "GB",
        "type": "normal",
        "type_label": "Dedicated Number",
        "sms_capable": false,
        "region": "us1",
        "has_active_subscription": true,
        "created_at": "2025-01-05T14:20:00.000000Z"
      }
    ]
  }
  ```
</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>