Sign In

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.