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

# Rechercher des numéros de téléphone disponibles

> Recherche des numéros de téléphone disponibles à l’achat

<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 vous permet de rechercher des numéros de téléphone disponibles auprès de notre fournisseur. Utilisez les résultats pour trouver un numéro que vous souhaitez acheter.

### Paramètres de requête

<ParamField query="country_code" type="string" default="DE">
  Le code pays ISO 3166-1 alpha-2 dans lequel effectuer la recherche (par ex. DE, GB, AU, CA)
</ParamField>

<ParamField query="contains" type="string">
  Filtre les numéros de téléphone contenant des chiffres spécifiques (caractères numériques uniquement, 10 chiffres maximum)
</ParamField>

### Champs de réponse

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

  <Expandable title="Propriétés du numéro disponible">
    <ResponseField name="phone_number" type="string">
      Le numéro de téléphone au format E.164
    </ResponseField>

    <ResponseField name="phone_number_formatted" type="string">
      Le numéro de téléphone formaté pour l’affichage
    </ResponseField>

    <ResponseField name="country_code" type="string">
      Le code pays ISO
    </ResponseField>

    <ResponseField name="price" type="number">
      Prix de location mensuel en USD
    </ResponseField>

    <ResponseField name="stripe_price_id" type="string">
      L’identifiant de prix Stripe pour la facturation
    </ResponseField>

    <ResponseField name="address_requirements" type="string">
      Exigences d’adresse pour ce numéro : `none`, `local`, `foreign` ou `inventory`
    </ResponseField>

    <ResponseField name="sms_capable" type="boolean">
      Indique si le numéro prend en charge les SMS
    </ResponseField>
  </Expandable>
</ResponseField>

### Pays pris en charge

| Pays        | Code |
| ----------- | ---- |
| Allemagne   | DE   |
| États-Unis  | US   |
| Canada      | CA   |
| Royaume-Uni | GB   |
| Australie   | AU   |
| Israël      | IL   |
| Pologne     | PL   |
| Finlande    | FI   |
| Pays-Bas    | NL   |
| Danemark    | DK   |
| Italie      | IT   |

<ResponseExample>
  ```json 200 Success theme={null}
  {
    "data": [
      {
        "phone_number": "+14155551234",
        "phone_number_formatted": "+1 415-555-1234",
        "country_code": "US",
        "price": 3.99,
        "stripe_price_id": "price_1PkA4dBXoZOzqQuAsvGvVJTZ",
        "address_requirements": "none",
        "sms_capable": true
      },
      {
        "phone_number": "+14155555678",
        "phone_number_formatted": "+1 415-555-5678",
        "country_code": "US",
        "price": 3.99,
        "stripe_price_id": "price_1PkA4dBXoZOzqQuAsvGvVJTZ",
        "address_requirements": "none",
        "sms_capable": false
      }
    ]
  }
  ```

  ```json 200 Empty Response theme={null}
  {
    "data": []
  }
  ```
</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>