Consulta Simples
API de consulta de CPF.
Nome e nascimento na hora.
A API de consulta de CPF da CPFHub.io recebe um CPF e devolve nome completo, gênero e data de nascimento em JSON. Cada CPF encontrado custa 1 crédito, de R$ 0,19 a R$ 0,10 por consulta conforme o plano, e CPF não encontrado não é cobrado. Teste no plano grátis, com 50 créditos por mês e sem cartão.
50 créditos grátis por mês, sem cartão de crédito.
O que você recebe
O CPF entra. A pessoa sai.
Onze dígitos viram um cadastro preenchido, antes de a pessoa terminar de digitar.
O nome do titular
Nome completo, com acentuação. O campo nameUpper traz o mesmo nome em caixa alta, pronto para comparar com o que a pessoa digitou.
namenameUpperA data de nascimento
Em DD/MM/AAAA e também separada em dia, mês e ano. Calcular a idade vira uma conta simples, sem tratar texto.
birthDatedaymonthyearO gênero
M ou F, conforme o cadastro. Pode vir null quando o dado não existe.
genderO CPF padronizado
Os 11 dígitos, sem pontos nem traço, mesmo que você envie o CPF com máscara.
cpfA Consulta Simples não retorna situação cadastral, ano do óbito, endereço, telefone nem e‑mail. Para situação cadastral e comprovante, use a Consulta em Tempo Real.
Ver a referência completa da respostaComo funciona
Três passos, nenhum burocrático.
Da conta criada ao primeiro JSON em produção, sem intermediário comercial no caminho.
- 01
Crie a conta e copie a chave
Cadastro self-serve em app.cpfhub.io, sem e-CNPJ, certificado digital ou contrato. A chave de API aparece no painel logo após o cadastro.
- 02
Chame GET /cpf/{cpf}
Uma requisição HTTP com o header x-api-key. O CPF vai na URL, com ou sem máscara. Sem corpo, sem OAuth e sem token que expira.
- 03
Receba o JSON e siga
Nome, gênero e data de nascimento voltam na mesma chamada. O formulário se preenche sozinho ou a sua regra de validação decide na hora.
Integre em qualquer linguagem
API REST com spec OpenAPI e exemplos prontos, simples o suficiente para o seu agente de IA integrar sozinho.
# Envie o CPF, receba nome, gênero e nascimento
curl -X GET \
'https://api.cpfhub.io/cpf/12345678909' \
-H 'x-api-key: YOUR_API_KEY'{
"success": true,
"data": {
"cpf": "12345678909",
"name": "Fulano de Tal",
"nameUpper": "FULANO DE TAL",
"gender": "M",
"birthDate": "15/06/1990",
"day": 15,
"month": 6,
"year": 1990
}
}50 créditos grátis por mês, sem cartão.
Onde usar
Feita para o caminho crítico.
Onde a consulta substitui digitação manual, conferência por telefone e retrabalho no cadastro.
Preencher formulário de cadastro
A pessoa digita o CPF e o resto do formulário se completa. Menos campos para preencher é menos abandono, e os dados entram no seu banco já padronizados.
Antifraude no cadastro e no checkout
Compare o nome e a data que a pessoa informou com o que a API devolve. Divergência vira revisão manual em vez de chargeback.
Verificação de idade
O campo year vem separado justamente para isso. Calcule a idade sem parsear string e aplique sua regra de faixa etária.
Higienização de cadastro
Base antiga com nome digitado errado ou faltando data de nascimento. Passe os CPFs pela API e normalize o cadastro inteiro.
Conferência no atendimento
O atendente confirma nome e nascimento do titular em tempo de ligação, sem depender do que o cliente lembra na hora.
Agentes de IA via MCP
O servidor MCP oficial expõe a consulta como tool. Claude, Cursor e Windsurf consultam CPF sem você escrever cliente HTTP.
Créditos e erros
CPF não encontrado não cobra crédito.
Você paga por resultado, não por tentativa. Base suja não vira fatura inflada.
Como o crédito é debitado
- Consulta com CPF encontrado consome 1 crédito.
- CPF sem registro na base devolve 404 e não consome crédito.
- CPF com formato ou dígito verificador incorreto devolve 400 ou 422 e não é consultado nem cobrado.
- GET /quota mostra o saldo e nunca consome crédito.
- Limite padrão de 30 requisições por minuto por chave (cada lote conta como 1). Acima disso, a API responde 429 e não consome crédito.
Códigos de resposta
| 200 | CPF encontrado. Consome 1 crédito. |
| 400 | O CPF não tem 11 dígitos depois de removidos os caracteres não numéricos. |
| 401 | Chave de API ausente ou inválida. |
| 403 | Créditos esgotados em plano sem excedente, ou conta inativa. |
| 404 | CPF válido, mas sem registro. Não consome crédito. |
| 422 | Dígito verificador incorreto, incluindo sequências repetidas. |
| 429 | Mais de 30 requisições por minuto. Aguarde o tempo do header Retry-After. Não consome crédito. |
Planos
Comece no Grátis. Suba quando precisar.
O mesmo saldo vale na Consulta Simples (1 crédito) e na Consulta em Tempo Real (1,5 crédito). Você troca de rota sem trocar de plano.
Grátis
R$ 0
50 créditos por mês, sem cartão
SLA 95%
Pro
A partir de R$ 19
100 a 10.000 créditos/mês, excedente de R$ 0,19 a R$ 0,10
SLA 99%
Corporativo
Sob consulta
Acima de 10.000 créditos por mês
SLA 99,9%
Em produção
Já roda no cadastro de quem escala.
7.000+
empresas atendidas
30 mi+
de CPFs verificados
50
créditos grátis por mês, sem cartão
Perguntas frequentes
O que a API de consulta de CPF retorna?
Nome completo, gênero (M/F) e data de nascimento. Campos: cpf (11 dígitos sem máscara), name, nameUpper, gender, birthDate, day, month e year. Não retorna score, endereço, telefone nem e-mail. Para situação cadastral, ano do óbito e comprovante, use a Consulta em Tempo Real em /consulta-cpf-receita-federal.
A API oferece consulta individual e em lote?
Sim. Consulta Simples em GET /cpf/{cpf} e lote em POST /cpf/bulk (até 10.000 CPFs, job assíncrono com poll em GET /cpf/bulk/{jobId}). Também há GET /quota para saldo e plano, sem consumir crédito.
Preciso de e-CNPJ ou certificado digital?
Não. A integração é self-serve: crie a conta, copie a chave de API no painel e envie no header x-api-key. Sem e-CNPJ e sem biometria.
Quanto custa a API de consulta de CPF?
Grátis: 50 créditos por mês, sem cartão, SLA de 95%. Pro: a partir de R$ 19 por mês com 100 créditos (até 10.000), excedente de R$ 0,19 a R$ 0,10 por crédito conforme o volume, SLA de 99%. Corporativo: sob consulta, SLA de 99,9%. Veja /precos.
Qual a diferença para a Consulta em Tempo Real?
A Consulta Simples precisa só do CPF e responde a partir da nossa base, com nome, gênero e nascimento, por 1 crédito. A Consulta em Tempo Real precisa também da data de nascimento do titular, faz a consulta em tempo real na Receita Federal e devolve situação cadastral, ano do óbito (deathYear, inteiro ou null), código de controle e comprovante em HTML, por 1,5 crédito por consulta bem-sucedida. As duas usam a mesma chave e o mesmo saldo.
Existe limite de requisições?
Sim, por minuto e por chave de API: 30 requisições por minuto na Consulta Simples (cada lote conta como 1) e 5 na Consulta em Tempo Real. Acima disso, a API responde 429 com Retry-After, sem consumir crédito. O consumo é controlado pelo saldo de créditos do plano. No Grátis (50 créditos/mês), a API para quando os créditos acabam. Planos pagos com excedente ativo continuam respondendo e o excedente é cobrado no ciclo seguinte.
CPF não encontrado consome crédito?
Não. Apenas consultas que retornam dados consomem crédito. CPF válido sem registro devolve 404 sem cobrança, e CPF com dígito verificador incorreto devolve 422 sem ser consultado.
A API funciona com agentes de IA?
Sim. O servidor MCP oficial fica em https://api.cpfhub.io/mcp e expõe a consulta como tool para Claude, Cursor e Windsurf, com a mesma chave de API. Não é preciso escrever um cliente HTTP.
A API está em conformidade com a LGPD?
Sim. Tratamos dados pessoais com base legal e práticas de privacidade. DPO: dpo@cpfhub.io. Política em /privacidade.
Integre a API de CPF
em minutos.
- 50 créditos grátis por mês
- Sem cartão de crédito
- Atendimento 24h no WhatsApp