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

# Verfügbare Telefonnummern abrufen

> Alle verfügbaren Telefonnummern für die Assistenten-Zuweisung abrufen

<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 gibt eine Liste der Telefonnummern zurück, die dem authentifizierten Benutzer gehören und Assistenten zugewiesen werden können, mit optionaler Filterung nach Assistenten-Typ.

### Query-Parameter

<ParamField query="type" type="string">
  Telefonnummern nach Assistenten-Typ filtern. Optionen: `inbound`, `outbound`
</ParamField>

### Antwort-Felder

Die API gibt ein direktes Array von verfügbaren Telefonnummern zurück:

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

  <Expandable title="Telefonnummer-Eigenschaften">
    <ResponseField name="id" type="integer">
      Die eindeutige Kennung der Telefonnummer
    </ResponseField>

    <ResponseField name="phone_number" type="string">
      Die Telefonnummer im E.164-Format
    </ResponseField>

    <ResponseField name="country_code" type="string">
      Der Ländercode für die Telefonnummer
    </ResponseField>

    <ResponseField name="type_label" type="string">
      Das menschenlesbare Typ-Label für die Telefonnummer
    </ResponseField>

    <ResponseField name="is_available" type="boolean">
      Ob die Telefonnummer für die Zuweisung verfügbar ist (nicht aktuell einem Inbound-Assistenten zugewiesen)
    </ResponseField>
  </Expandable>
</ResponseField>

### Hinweise

* Nur Telefonnummern, die dem authentifizierten Benutzer gehören, werden zurückgegeben
* Wenn `type=inbound` angegeben wird, werden Caller-ID-Nummern und bereits zugewiesene Nummern herausgefiltert
* Das `is_available`-Feld zeigt an, ob die Nummer einem neuen Inbound-Assistenten zugewiesen werden kann
* Telefonnummern werden im Values-Collection-Format zurückgegeben (indiziertes Array)
* Verwende das `id`-Feld beim Zuweisen von Telefonnummern zu Assistenten

<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 Nur Inbound-verfügbare Nummern 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>
  Passende Seiten: [Introduction](/de/api-v1/introduction) und [Authentication Guide](/de/api-v1/authentication) und [API Integration Examples](/de/api-v1/introduction).
</Tip>