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

# Verfügbare Telefonnummern suchen

> Sucht nach verfügbaren Telefonnummern, die gekauft werden können

Dieser Endpunkt ermöglicht es dir, nach verfügbaren Telefonnummern von unserem Anbieter zu suchen. Verwende die Ergebnisse, um eine Nummer zu finden, die du kaufen möchtest.

### Query-Parameter

<ParamField query="country_code" type="string" default="DE">
  Der ISO 3166-1 alpha-2 Ländercode, in dem gesucht werden soll (z.B. DE, GB, AU, CA)
</ParamField>

<ParamField query="contains" type="string">
  Filtert Telefonnummern, die bestimmte Ziffern enthalten (nur numerische Zeichen, maximal 10 Ziffern)
</ParamField>

### Antwort-Felder

<ResponseField name="data" type="array">
  Array von verfügbaren Telefonnummern

  <Expandable title="Verfügbare Nummer-Eigenschaften">
    <ResponseField name="phone_number" type="string">
      Die Telefonnummer im E.164-Format
    </ResponseField>

    <ResponseField name="phone_number_formatted" type="string">
      Die Telefonnummer formatiert für die Anzeige
    </ResponseField>

    <ResponseField name="country_code" type="string">
      Der ISO-Ländercode
    </ResponseField>

    <ResponseField name="price" type="number">
      Monatlicher Mietpreis in USD
    </ResponseField>

    <ResponseField name="stripe_price_id" type="string">
      Die Stripe-Preis-ID für die Abrechnung
    </ResponseField>

    <ResponseField name="address_requirements" type="string">
      Adressanforderungen für diese Nummer: `none`, `local`, `foreign` oder `inventory`
    </ResponseField>

    <ResponseField name="sms_capable" type="boolean">
      Ob die Nummer SMS unterstützt
    </ResponseField>
  </Expandable>
</ResponseField>

### Unterstützte Länder

| Land                   | Code |
| ---------------------- | ---- |
| Deutschland            | DE   |
| Vereinigte Staaten     | US   |
| Kanada                 | CA   |
| Vereinigtes Königreich | GB   |
| Australien             | AU   |
| Israel                 | IL   |
| Polen                  | PL   |
| Finnland               | FI   |
| Niederlande            | NL   |
| Dänemark               | DK   |
| Italien                | 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 Leere Antwort theme={null}
  {
    "data": []
  }
  ```
</ResponseExample>

<Tip>
  Passende Seiten: [Introduction](/de/api-reference/introduction) und [Authentication Guide](/de/developers/authentication-guide) und [API Integration Examples](/de/developers/api-integration-examples).
</Tip>