Telefone - Sherlocker

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

{
  "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.

⌘I