> ## 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 números de telefone disponíveis

> Recuperar todos os números de telefone disponíveis para atribuição de assistentes.

Este endpoint retorna uma lista de números de telefone pertencentes ao usuário autenticado que podem ser atribuídos aos assistentes, com filtragem opcional por tipo de assistente.

### Parâmetros de Consulta

<ParamField query="type" type="string" optional>
  Filtrar números de telefone por tipo de assistente. Opções: `inbound`, `outbound`
</ParamField>

### Campos de Resposta

<ResponseField name="data" type="array">
  <Expandable title="properties">
    <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
    </ResponseField>

    <ResponseField name="country_code" type="string">
      O código do país para o número de telefone
    </ResponseField>

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

    <ResponseField name="is_available" type="boolean">
      Se o número de telefone está disponível para atribuição (não está atualmente atribuído a um assistente de entrada)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 Response theme={null}
  [
    {
      "id": 45,
      "phone_number": "+1234567890",
      "country_code": "US",
      "type_label": "Normal",
      "is_available": true
    },
    {
      "id": 46,
      "phone_number": "+1234567891",
      "country_code": "US",
      "type_label": "SIP",
      "is_available": false
    },
    {
      "id": 47,
      "phone_number": "+441234567890",
      "country_code": "GB",
      "type_label": "Caller ID",
      "is_available": true
    }
  ]
  ```
</ResponseExample>

### Notas

* Apenas números de telefone pertencentes ao usuário autenticado são retornados
* Quando `type=inbound` é especificado, números de identificação de chamadas e números já atribuídos são filtrados
* O campo `is_available` indica se o número pode ser atribuído a um novo assistente de entrada
* Números de telefone são retornados no formato de coleção de valores (array indexado)
* Use o campo `id` ao atribuir números de telefone aos assistentes