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

<Warning>
  **Famulor 1.0 API (Legacy).** Diese Seite gilt nur für Famulor 1.0 (`app.famulor.de`) und bleibt aus Kompatibilitätsgründen erhalten. Für die aktuelle Plattform nutze die [Famulor 2.0 API-Referenz](/de/api-reference/introduction).
</Warning>

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>
  Verwandte Seiten: [Einführung](/de/api-v1/introduction) und [Authentifizierungs-Leitfaden](/de/api-v1/authentication) sowie [API-Integrationsbeispiele](/de/api-v1/introduction).
</Tip>