Um Telefone representa um numero telefonico associado a uma pessoa fisica. Pode ser fixo ou movel, com identificacao de operadora e estado.

​
Tipagem

{
  "ddi": "55",
  "ddd": "31",
  "numero": "987654321",
  "numero_completo": "5531987654321",
  "estado": "MG",
  "operadora": "Vivo",
  "tem_whatsapp": false
}
CampoTipoDescricao
ddistringCodigo do pais (sempre 55 para Brasil)
dddstringCodigo de area (2 digitos)
numerostringNumero sem DDD
numero_completostringDDI + DDD + numero (formato E.164 sem +)
estadostringUF derivada do DDD (ex: SP, MG, RJ)
operadorastringOperadora detectada: Vivo, Claro, Tim, Oi, Fixo
tem_whatsappbooleanSe o numero tem WhatsApp (verificacao via /perfis/whatsapp/)

​
Conexoes

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

​
Endpoints

RotaDescricao
GET /telefones/cpf/{cpf}Telefones de uma pessoa
GET /pessoas/telefone/{telefone}Busca reversa: CPFs por telefone