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

# Listar números de teléfono

> Recupera todos los números de teléfono del usuario autenticado

<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 todos los números de teléfono vinculados a tu cuenta, incluidos su estado de suscripción y sus capacidades.

<Note>
  También existe un endpoint heredado `GET /user/phone-numbers` que solo devuelve los números de teléfono con capacidad SMS que tienen suscripciones activas. Usa este endpoint `/all` cuando necesites todos los números de teléfono, independientemente de la capacidad SMS o del estado de la suscripción.
</Note>

### Campos de respuesta

<ResponseField name="data" type="array">
  Array de objetos de número de teléfono

  <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 (p. ej., +49155551234)
    </ResponseField>

    <ResponseField name="nickname" type="string">
      Una etiqueta breve y fácil de reconocer para el número (o `null` si no se ha definido)
    </ResponseField>

    <ResponseField name="country_code" type="string">
      El código de país ISO 3166-1 alpha-2 (p. ej., DE, GB, AU)
    </ResponseField>

    <ResponseField name="type" type="string">
      El tipo de número de teléfono: `normal`, `sip` o `caller_id`
    </ResponseField>

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

    <ResponseField name="sms_capable" type="boolean">
      Indica si el número de teléfono puede enviar y recibir SMS
    </ResponseField>

    <ResponseField name="region" type="string">
      La región en la que se aprovisionó el número de teléfono
    </ResponseField>

    <ResponseField name="has_active_subscription" type="boolean">
      Indica si el número de teléfono tiene una suscripción activa
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Marca de tiempo ISO 8601 de cuándo se compró el número de teléfono
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 Success theme={null}
  {
    "data": [
      {
        "id": 1,
        "phone_number": "+49155551234",
        "nickname": "Sales line",
        "country_code": "DE",
        "type": "normal",
        "type_label": "Dedicated Number",
        "sms_capable": true,
        "region": "us1",
        "has_active_subscription": true,
        "created_at": "2025-01-07T10:30:00.000000Z"
      },
      {
        "id": 2,
        "phone_number": "+442071234567",
        "nickname": null,
        "country_code": "GB",
        "type": "normal",
        "type_label": "Dedicated Number",
        "sms_capable": false,
        "region": "us1",
        "has_active_subscription": true,
        "created_at": "2025-01-05T14:20:00.000000Z"
      }
    ]
  }
  ```
</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>