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

# Obter todos os números de telefone

> Obter todos os números de telefone pertencentes ao usuário autenticado

Este endpoint retorna uma lista de todos os números de telefone associados à sua conta, incluindo seu status de assinatura e capacidades.

### Resposta

<ResponseField name="data" type="array">
  Array de objetos de números de telefone

  <Expandable title="propriedades dos números de telefone">
    <ResponseField name="id" type="integer">
      O identificador único do número de telefone
    </ResponseField>

    <ResponseField name="phone_number" type="string">
      O número de telefone no formato E.164 (por exemplo, +14155551234)
    </ResponseField>

    <ResponseField name="country_code" type="string">
      O código do país ISO 3166-1 alpha-2 (por exemplo, US, GB, AU)
    </ResponseField>

    <ResponseField name="type" type="string">
      O tipo do número de telefone: `normal`, `sip`, ou `caller_id`
    </ResponseField>

    <ResponseField name="type_label" type="string">
      Rótulo legível por humanos para o tipo de número de telefone
    </ResponseField>

    <ResponseField name="sms_capable" type="boolean">
      Se o número de telefone pode enviar e receber SMS
    </ResponseField>

    <ResponseField name="region" type="string">
      A região onde o número de telefone é provisionado
    </ResponseField>

    <ResponseField name="has_active_subscription" type="boolean">
      Se o número de telefone tem uma assinatura ativa
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Timestamp ISO 8601 de quando o número de telefone foi adquirido
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 Response theme={null}
  {
    "data": [
      {
        "id": 1,
        "phone_number": "+14155551234",
        "country_code": "US",
        "type": "normal",
        "type_label": "Número Dedicado",
        "sms_capable": true,
        "region": "us1",
        "has_active_subscription": true,
        "created_at": "2025-01-08T10:30:00.000000Z"
      },
      {
        "id": 2,
        "phone_number": "+442071234567",
        "country_code": "GB",
        "type": "normal",
        "type_label": "Número Dedicado",
        "sms_capable": false,
        "region": "us1",
        "has_active_subscription": true,
        "created_at": "2025-01-05T14:20:00.000000Z"
      }
    ]
  }
  ```
</ResponseExample>

<Note>
  Há também um endpoint legado `GET /user/phone-numbers` que retorna apenas números de telefone capazes de SMS com assinaturas ativas. Use este endpoint `/all` se você precisar de todos os números de telefone independentemente da capacidade de SMS ou status de assinatura.
</Note>