Sign In

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.