Consulta CPF — Dados básicos
Last updated
Retorna identificação, filiação, situação cadastral e documentos complementares vinculados ao CPF informado.
| Propriedade | Valor |
|---|---|
| Dataset | cpf_dados_basicos |
| Método e caminho | POST /datasets/cpf_dados_basicos/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_basicos/queries' \
--header 'Authorization: Bearer <API_KEY>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: exemplo-cpf-dados-basicos-001' \
--data '{"cpf":"52998224725"}'
{
"cpf": "52998224725"
}
| Campo | Tipo | Obrigatório | Regras |
|---|---|---|---|
cpf |
string |
Sim | Exatamente 11 dígitos, sem pontuação ou espaços. Os dígitos verificadores são conferidos; 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. A validação dos 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
Os dados abaixo são sintéticos. O CPF é usado de forma didática; nomes e documentos complementares não representam uma resposta garantida nem comprovam titularidade. O envelope comum inclui este objeto em data quando a consulta termina com dados.
{
"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
}
}
}
Contrato de data
data é um objeto ou null. Quando o objeto existe, todas as propriedades abaixo estão presentes; não há propriedades adicionais. Campos textuais não anuláveis podem ser "" quando não informados, exceto cpf e name, exigidos para um resultado válido. Textos são retornados sem caracteres de controle, com até 500 unidades UTF-16. Datas representam o dia civil no formato YYYY-MM-DD, sem horário ou conversão de fuso.
| Campo | Tipo | Descrição |
|---|---|---|
cpf |
string |
CPF consultado, com 11 dígitos sem pontuação. |
name |
string |
Nome informado no cadastro. |
sex |
string |
Sexo conforme informação disponível. Não possui enumeração fixa no contrato. |
registration_status |
string |
Situação cadastral conforme informação disponível. Não possui enumeração fixa no contrato. |
birth_date |
string ou null |
Data de nascimento em YYYY-MM-DD; null quando ausente ou não aproveitável. |
mother_name |
string ou null |
Nome da mãe, quando informado. |
father_name |
string ou null |
Nome do pai, quando informado. |
registration_status_date |
string ou null |
Data da situação cadastral em YYYY-MM-DD, quando aproveitável. |
documents |
object |
Documentos complementares. Está presente mesmo quando todos os seus valores são null. |
documents.pis |
string ou null |
Identificador PIS, quando informado. |
documents.work_card |
string ou null |
Identificação da carteira de trabalho, quando informada. |
documents.voter_registration |
string ou null |
Identificação do título de eleitor, quando informada. |
documents.identity_card |
object |
Documento de identidade; suas três propriedades sempre estão presentes. |
documents.identity_card.number |
string ou null |
Número do documento de identidade. |
documents.identity_card.issuer |
string ou null |
Órgão emissor. |
documents.identity_card.state |
string ou null |
UF informada para o documento. |
Documentos complementares são textos; o contrato não garante um formato, uma máscara ou a validação dos seus dígitos. Preserve zeros iniciais.
Ausência de dados e cobrança
Uma ausência reconhecida de cadastro produz status: "no_data" e data: null, sem cobrança. Falta ou inconsistência de CPF e nome em uma resposta de cadastro não é convertida em um cadastro vazio: a consulta falha, sem cobrança. Campos complementares ausentes, isoladamente, não impedem um resultado com dados.
Em uma consulta comum com status: "succeeded", aplica-se o preço efetivo da conta. Consulte GET /datasets para disponibilidade, schema e preço vigentes, e o campo billing para a cobrança da operação. Veja resultados e erros.
Consultas em lote
O dataset aceita POST /datasets/cpf_dados_basicos/batches quando batch.enabled estiver habilitado no catálogo. Cada CPF usa este mesmo contrato de dados. Limites, validação por entrada, reserva, cobrança consolidada, recuperação e webhook estão descritos em consultas em lote.