API de consulta de CPF
O endpoint de CPF valida o número (dígitos verificadores) e retorna os dados cadastrais associados de forma estruturada — identificação, endereços e indicadores de qualidade por resultado. É destinado a fluxos legítimos de onboarding (KYC), análise de crédito, prevenção à fraude e validação cadastral, com registro de auditoria por requisição.
Para que serve
- Onboarding e KYC: confirmar titularidade antes de liberar cadastro.
- Antifraude: cruzar CPF informado com dados cadastrais na abertura de conta.
- Análise de crédito e validação cadastral em processos autorizados.
Requisição
Autentique com o header Authorization: Bearer — gere seu token no dashboard após ativar um plano.
curl -X POST "https://apiconsultas.xyz/api/v1/consultas/cpf" \
-H "Authorization: Bearer dp_live_xxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"cpf":"12345678909"}'const res = await fetch("https://apiconsultas.xyz/api/v1/consultas/cpf", {
method: "POST",
headers: {
Authorization: "Bearer dp_live_xxxxxxxxxxxxxxxxx",
"Content-Type": "application/json",
},
body: JSON.stringify({"cpf":"12345678909"}),
});
const data = await res.json();<?php
$ch = curl_init("https://apiconsultas.xyz/api/v1/consultas/cpf");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer dp_live_xxxxxxxxxxxxxxxxx",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => '{"cpf":"12345678909"}',
]);
$data = json_decode(curl_exec($ch), true);Resposta (200)
Exemplo com valores ilustrativos. O nível de detalhe (dados completos ou mascarados) depende do seu plano.
{
"success": true,
"consulta_id": "8f3c…",
"tipo_consulta": "cpf",
"query": {
"termo_mascarado": "123.***.**9-09",
"finalidade": "antifraude"
},
"resultado_count": 1,
"credits_used": 0,
"permission_badge": "Elite — dados completos",
"data_quality": {
"sources_used": 3,
"confidence_score": 90,
"has_contacts": true,
"has_address": true,
"has_company_links": false
},
"data": [
{
"identificacao": {
"nome": "NOME DO TITULAR",
"documento": "12345678909",
"data_nascimento": "1990-01-01"
},
"contato": {
"telefones": [
"(11) 9****-**99"
],
"emails": [
"n***@exemplo.com"
]
},
"localizacao": {
"cidade": "São Paulo",
"estado": "SP",
"cep": "01001-000"
}
}
],
"audit": {
"logged": true,
"timestamp": "2026-07-01T12:00:00.000Z"
},
"message": "Consulta realizada com sucesso."
}Campos retornados
| Campo | Descrição |
|---|---|
| identificacao.nome | Nome associado ao CPF. |
| identificacao.documento | CPF normalizado (mascarado conforme o plano). |
| identificacao.data_nascimento | Data de nascimento, quando disponível. |
| contato.telefones / emails | Contatos vinculados, quando disponíveis. |
| localizacao.enderecos_detalhados | Endereços estruturados (logradouro, bairro, cidade, UF, CEP). |
| data_quality | sources_used e confidence_score do resultado. |
| audit | Carimbo de auditoria (logged + timestamp). |
Perguntas frequentes
A API valida o CPF antes de consultar?
Sim. O número passa por checagem de formato e dígitos verificadores; CPFs inválidos retornam erro 400 sem consumir a consulta.
Os dados vêm mascarados?
O nível de detalhe depende do plano e do escopo do token. Planos de nível superior exibem dados completos; os demais recebem campos mascarados. Cada resposta traz um permission_badge indicando o nível.
Posso usar para qualquer finalidade?
Não. O uso é restrito a finalidades legítimas — antifraude, validação cadastral, KYC, análise de crédito e due diligence — em conformidade com a LGPD. Cada requisição é auditada.
Endpoints relacionados
Integre consulta de cpf hoje
Ative um plano a partir de R$ 10, gere seu token Bearer e comece a consultar em minutos. Consultas ilimitadas enquanto o plano estiver ativo.