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

# Telefone

> Registro de telefone vinculado a um CPF

Um **Telefone** representa um número telefônico associado a uma pessoa física. Pode ser fixo ou móvel, com identificação de operadora e estado.

## Tipagem

```json theme={null}
{
  "ddi": "55",
  "ddd": "31",
  "numero": "987654321",
  "numero_completo": "5531987654321",
  "estado": "MG",
  "operadora": "Vivo",
  "data": "2024-01-01"
}
```

| Campo             | Tipo           | Descrição                                                                        |
| ----------------- | -------------- | -------------------------------------------------------------------------------- |
| `ddi`             | string         | Código do país (sempre `55` para Brasil)                                         |
| `ddd`             | string         | Código de área (2 dígitos)                                                       |
| `numero`          | string         | Número sem DDD                                                                   |
| `numero_completo` | string         | DDI + DDD + número (formato E.164 sem +)                                         |
| `estado`          | string         | UF derivada do DDD (ex: `SP`, `MG`, `RJ`)                                        |
| `operadora`       | string         | Operadora detectada: `Vivo`, `Claro`, `Tim`, `Oi`, `Fixo`                        |
| `data`            | string \| null | Ano de referência do registro no formato `YYYY-01-01`, ou `null` se indisponível |

## Conexões

* **Pessoa** — todo telefone pertence a um CPF
* **Empresa** — empresas têm telefones comerciais (ddd1/telefone1, ddd2/telefone2)
* **Banco** — bancos podem retornar telefones vinculados a contas

## Endpoints

| Rota                               | Descrição                        |
| ---------------------------------- | -------------------------------- |
| `GET /telefones/cpf/{cpf}`         | Telefones de uma pessoa          |
| `GET /pessoas/telefone/{telefone}` | Busca reversa: CPFs por telefone |

A busca reversa suporta paginação com `limit` (padrão 50, max 200) e `offset` (padrão 0) via query params.