Consulta CPF — Dados completos
Last updated
Reúne dados básicos, endereços, telefones e e-mails vinculados ao CPF em uma única consulta. Cada grupo mantém o mesmo contrato da consulta individual correspondente.
| Propriedade | Valor |
|---|---|
| Dataset | cpf_dados_completos |
| Método e caminho | POST /datasets/cpf_dados_completos/queries |
Versão do schema de dados (schema_version) |
1.0.0 |
| Entrada | CPF |
| Consultas em lote | Suportadas, conforme disponibilidade no catálogo |
Requisição
curl --request POST 'https://api.verifica-online.com.br/datasets/cpf_dados_completos/queries' \
--header 'Authorization: Bearer <API_KEY>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: exemplo-cpf-dados-completos-001' \
--data '{"cpf":"52998224725"}'
{
"cpf": "52998224725"
}
| Campo | Tipo | Obrigatório | Regras |
|---|---|---|---|
cpf |
string |
Sim | Exatamente 11 dígitos, sem pontuação ou espaços, com dígitos verificadores válidos. Sequências de um único dígito repetido são rejeitadas. |
O corpo aceita somente cpf; campos adicionais e CPF numérico são rejeitados. Não são aceitos parâmetros de consulta na URL. Validar os dígitos não comprova existência, identidade ou titularidade do documento.
Veja autenticação e requisições, idempotência e cobrança.
Exemplo de data
O CPF é didático e os nomes, endereço e telefone abaixo são sintéticos. O e-mail utiliza o domínio reservado example.com. O exemplo não representa uma resposta garantida, não comprova titularidade e não deve ser utilizado para contato. O envelope comum contém os campos externos a data.
{
"cpf": "52998224725",
"basic": {
"cpf": "52998224725",
"name": "Pessoa de Exemplo",
"sex": "F",
"registration_status": "Regular",
"birth_date": "1990-04-15",
"mother_name": "Mãe de Exemplo",
"father_name": null,
"registration_status_date": "2026-09-01",
"documents": {
"pis": null,
"work_card": null,
"voter_registration": null,
"identity_card": {
"number": null,
"issuer": null,
"state": null
}
}
},
"addresses": [
{
"street_type": "Rua",
"street": "Exemplo",
"number": "100",
"complement": "Sala de Exemplo",
"district": "Bairro de Exemplo",
"city": "São Paulo",
"state": "SP",
"postal_code": "00000000",
"type": "Residencial",
"full_address": "Rua Exemplo, 100, Sala de Exemplo, Bairro de Exemplo, São Paulo - SP",
"priority": 1,
"latitude": null,
"longitude": null
}
],
"phones": [
{
"country_code": "55",
"area_code": "11",
"number": "900000000",
"e164": "+5511900000000",
"type": "mobile",
"priority": 1,
"has_whatsapp": null
}
],
"emails": [
{
"email": "contato@example.com",
"domain": "example.com",
"username": "contato",
"type": "personal",
"priority": 1,
"similarity": 95.5,
"quality": null
}
]
}
Contrato de data
data é um objeto ou null. Quando há dados, todas as propriedades dos objetos existentes estão presentes, sem propriedades adicionais. Campos textuais não anuláveis podem ser "", exceto CPF e nome do grupo básico, necessários para um cadastro válido. Textos são retornados sem caracteres de controle. Limites de texto são medidos em unidades UTF-16; datas usam YYYY-MM-DD sem horário.
| Campo | Tipo | Descrição e limites |
|---|---|---|
cpf |
string |
CPF consultado, com 11 dígitos sem pontuação. |
basic |
object ou null |
Dados básicos. null representa ausência reconhecida desse grupo. |
addresses |
array<object> |
Até 1.000 endereços; [] quando nenhum endereço aproveitável está disponível. |
phones |
array<object> |
Até 1.000 telefones; [] quando nenhum telefone aproveitável está disponível. |
emails |
array<object> |
Até 1.000 e-mails; [] quando nenhum e-mail aproveitável está disponível. |
Não há campos total para as listas nesta consulta. Use o comprimento de cada array.
Dados básicos
| Campo | Tipo | Descrição |
|---|---|---|
basic.cpf |
string |
CPF do cadastro, igual ao consultado, sem pontuação. |
basic.name |
string |
Nome cadastral; até 500 unidades. |
basic.sex |
string |
Sexo informado, sem enumeração fixa; até 500 unidades. |
basic.registration_status |
string |
Situação cadastral, sem enumeração fixa; até 500 unidades. |
basic.birth_date |
string ou null |
Data de nascimento em YYYY-MM-DD, quando aproveitável. |
basic.mother_name |
string ou null |
Nome da mãe; até 500 unidades. |
basic.father_name |
string ou null |
Nome do pai; até 500 unidades. |
basic.registration_status_date |
string ou null |
Data da situação cadastral em YYYY-MM-DD. |
basic.documents |
object |
Documentos complementares, presente mesmo quando seus valores são null. |
basic.documents.pis |
string ou null |
Identificador PIS; até 500 unidades. |
basic.documents.work_card |
string ou null |
Identificação da carteira de trabalho; até 500 unidades. |
basic.documents.voter_registration |
string ou null |
Identificação do título de eleitor; até 500 unidades. |
basic.documents.identity_card |
object |
Documento de identidade, com as três propriedades abaixo. |
basic.documents.identity_card.number |
string ou null |
Número do documento; até 500 unidades. |
basic.documents.identity_card.issuer |
string ou null |
Órgão emissor; até 500 unidades. |
basic.documents.identity_card.state |
string ou null |
UF informada; até 500 unidades. |
Documentos complementares permanecem textuais, sem garantia de máscara, formato ou validação de dígitos. Veja também dados básicos.
Endereços
| Campo | Tipo | Descrição e limites |
|---|---|---|
addresses[].street_type |
string |
Tipo do logradouro; até 500 unidades. |
addresses[].street |
string |
Nome do logradouro; até 500 unidades. |
addresses[].number |
string |
Número preservado como texto; até 500 unidades. |
addresses[].complement |
string |
Complemento; até 500 unidades. |
addresses[].district |
string |
Bairro; até 500 unidades. |
addresses[].city |
string |
Município; até 500 unidades. |
addresses[].state |
string |
UF em maiúsculas. |
addresses[].postal_code |
string |
CEP com apenas dígitos; até 500 unidades. Pode estar incompleto. Preserve zeros iniciais. |
addresses[].type |
string |
Classificação do endereço, sem enumeração fixa; até 500 unidades. |
addresses[].full_address |
string |
Endereço completo informado; até 1.000 unidades. |
addresses[].priority |
integer ou null |
Prioridade informada; pode ser negativa. |
addresses[].latitude |
number ou null |
Latitude entre −90 e 90 graus, quando aproveitável. |
addresses[].longitude |
number ou null |
Longitude entre −180 e 180 graus, quando aproveitável. |
Um endereço precisa ter logradouro ou endereço completo aproveitável. A lista contém endereços únicos pela combinação de CEP, logradouro, número, complemento, município e UF, sem distinguir maiúsculas de minúsculas. A ordenação é por prioridade crescente. Ausência de prioridade é tratada como o menor nível de prioridade; a ordem entre itens de mesma prioridade não é garantida. Veja endereços.
Telefones
| Campo | Tipo | Descrição e limites |
|---|---|---|
phones[].country_code |
string |
Código de discagem internacional, com um a três dígitos, sem +. |
phones[].area_code |
string |
Código de área, com dois dígitos. |
phones[].number |
string |
Número local, com oito ou nove dígitos, sem máscara. |
phones[].e164 |
string |
+ seguido de código do país, código de área e número local. |
phones[].type |
string |
mobile, landline ou unknown. |
phones[].priority |
integer ou null |
Prioridade informada; pode ser negativa. |
phones[].has_whatsapp |
boolean ou null |
Indicação reconhecida de WhatsApp; null quando desconhecida. |
Os componentes numéricos são retornados somente com dígitos e seguem os comprimentos indicados. A lista contém valores únicos de e164, ordenados por prioridade crescente. Ausência de prioridade é tratada como o menor nível de prioridade; a ordem entre itens de mesma prioridade não é garantida. O formato não comprova funcionamento da linha ou acesso ao WhatsApp. Veja telefones.
E-mails
| Campo | Tipo | Descrição e limites |
|---|---|---|
emails[].email |
string |
Endereço completo em minúsculas. |
emails[].domain |
string |
Parte do endereço após @, em minúsculas. |
emails[].username |
string |
Parte do endereço antes de @, em minúsculas. |
emails[].type |
string |
personal, business ou unknown. |
emails[].priority |
integer ou null |
Prioridade informada; pode ser negativa. |
emails[].similarity |
number ou null |
Indicador de similaridade entre 0 e 100, sem garantia de titularidade ou precisão. |
emails[].quality |
boolean ou null |
Indicador de qualidade; null quando desconhecido. |
Os e-mails retornados seguem a estrutura descrita na consulta de e-mails. A lista contém endereços completos únicos em minúsculas, ordenados por prioridade crescente. Ausência de prioridade é tratada como o menor nível de prioridade; a ordem entre itens de mesma prioridade não é garantida. A consulta não confirma existência da caixa postal ou entrega de mensagens.
Ausência de dados e cobrança
Os dados válidos disponíveis são entregues mesmo quando parte da execução falha, com status: "partial". O schema é preservado: basic pode ser null e listas indisponíveis ficam []. Consulte os descontos.
Se todos os grupos concluírem validamente sem dados úteis, o resultado é no_data; sem dados úteis e com falha, é failed. Ambos ficam sem cobrança e com data: null. Com dados e sem falhas, o estado é succeeded e aplica-se o preço efetivo da consulta completa.
Consulte GET /datasets para disponibilidade, schema e preço vigentes, e billing para a cobrança da operação. Veja resultados e erros.
Consultas em lote
O dataset aceita POST /datasets/cpf_dados_completos/batches quando batch.enabled estiver habilitado no catálogo. Cada CPF usa o objeto consolidado documentado nesta página. Veja consultas em lote para limites, validação por entrada, reserva, cobrança consolidada, recuperação e webhook.