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

# Obtener números de teléfono disponibles

> Obtén todos los números de teléfono disponibles para asignar a un asistente

<Warning>
  **API de Famulor 1.0 (legado).** Esta página se aplica únicamente a Famulor 1.0 (`app.famulor.de`) y se conserva por compatibilidad. Para la plataforma actual, usa la [referencia de la API de Famulor 2.0](/es/api-reference/introduction).
</Warning>

Este endpoint devuelve una lista de los números de teléfono que pertenecen al usuario autenticado y que se pueden asignar a asistentes, con filtrado opcional por tipo de asistente.

### Parámetros de consulta

<ParamField query="type" type="string">
  Filtra los números de teléfono por tipo de asistente. Opciones: `inbound`, `outbound`
</ParamField>

### Campos de respuesta

La API devuelve un array directo de números de teléfono disponibles:

<ResponseField name="array" type="array">
  Array de números de teléfono disponibles

  <Expandable title="Propiedades del número de teléfono">
    <ResponseField name="id" type="integer">
      El identificador único del número de teléfono
    </ResponseField>

    <ResponseField name="phone_number" type="string">
      El número de teléfono en formato E.164
    </ResponseField>

    <ResponseField name="country_code" type="string">
      El código de país del número de teléfono
    </ResponseField>

    <ResponseField name="type_label" type="string">
      La etiqueta de tipo legible del número de teléfono
    </ResponseField>

    <ResponseField name="is_available" type="boolean">
      Indica si el número de teléfono está disponible para asignación (no está actualmente asignado a un asistente entrante)
    </ResponseField>
  </Expandable>
</ResponseField>

### Notas

* Solo se devuelven los números de teléfono que pertenecen al usuario autenticado
* Cuando se especifica `type=inbound`, se excluyen los números de identificador de llamadas y los que ya están asignados
* El campo `is_available` indica si el número se puede asignar a un nuevo asistente entrante
* Los números de teléfono se devuelven en formato de colección de valores (array indexado)
* Usa el campo `id` al asignar números de teléfono a asistentes

<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 Inbound-only available numbers 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>
  Páginas relacionadas: [Introducción](/es/api-v1/introduction) y [Guía de autenticación](/es/api-v1/authentication), y [Ejemplos de integración de la API](/es/api-v1/introduction).
</Tip>