> ## Documentation Index
> Fetch the complete documentation index at: https://doc.omnitechsolucoes.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Obter números de telefone disponíveis

> Recupera todos os números de telefone disponíveis na sua conta OmniTech para atribuição a assistentes de IA inbound e outbound, com país e tipo.

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

### Parâmetros de Consulta

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

### Campos da Resposta

<ResponseField name="data" type="array">
  <Expandable title="propriedades">
    <ResponseField name="id" type="integer">
      Identificador único do número de telefone
    </ResponseField>

    <ResponseField name="phone_number" type="string">
      Número de telefone no formato E.164
    </ResponseField>

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

    <ResponseField name="type_label" type="string">
      Rótulo do tipo do número de telefone em formato legível
    </ResponseField>

    <ResponseField name="is_available" type="boolean">
      Indica se o número de telefone está disponível para atribuição (não está atualmente atribuído a um assistente inbound)
    </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>

Observações
Apenas números de telefone pertencentes ao usuário autenticado são retornados

Quando type=inbound é especificado, números do tipo caller ID 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 inbound

Os números de telefone são retornados no formato de coleção de valores (array indexado)

Utilize o campo id ao atribuir números de telefone a assistentes