API REST

API de consulta de CPF

Integração self-serve para cadastro, antifraude leve e limpeza de base. Sem e-CNPJ. Sem biometria.

  • GET individual + lote

    GET /cpf/{cpf} para uma consulta. POST /cpf/bulk para até 10.000 CPFs por job assíncrono.

  • Nome, gênero e nascimento

    Resposta JSON com cpf (11 dígitos), name, nameUpper, gender, birthDate, day, month e year.

  • Self-serve, sem e-CNPJ

    API key no header x-api-key. Sem certificado digital e sem biometria. Documentação e dashboard prontos.

  • Escala em produção

    Mais de 2.500 empresas. 20 milhões de CPFs verificados. Clientes como iGreen e Tipspace.

Integre em qualquer linguagem

API REST com spec OpenAPI e exemplos prontos, simples o suficiente para o seu AI agent integrar sozinho.

cURLGET /cpf/12345678909
1
2
3
curl -X GET \
'https://api.cpfhub.io/cpf/12345678909' \
-H 'x-api-key: YOUR_API_KEY'
Resposta JSON200 OK
1
2
3
4
5
6
7
8
9
10
11
12
13
{
"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
}
}

Planos

Free 50. Pro a partir de R$149.

SLA por plano — não um uptime global. Créditos não acumulam. Só consulta encontrada consome 1 crédito.

Grátis

R$ 0

50 créditos/mês · sem cartão

SLA 95%

Pro

R$ 149

1.000 créditos · excedente R$ 0,15

SLA 99%

Corporativo

Sob consulta

Acima de 10.000 créditos/mês

SLA 99,9%

Ver preços e regras de billing →

Quando usar o quê

API comercial vs. canal oficial

A CPFHub.io não é o governo e não substitui o Serpro. Escolha a via certa para o seu caso.

Serpro / Receita (oficial)

Use o canal governamental quando precisar de situação cadastral na Receita, e-CNPJ, certificado digital ou de uma fonte oficial. É o caminho para obrigações que exigem o dado da administração pública.

CPFHub.io (comercial)

Use a API comercial para cadastro, antifraude leve e limpeza de base: nome, gênero e nascimento via GET ou lote, self-serve, sem e-CNPJ e sem biometria. A regra de match fica no seu sistema.

Em produção

iGreen e Tipspace já consultam

Mais de 2.500 empresas. 20 milhões de CPFs verificados.

iGreen Energy

iGreen Energy

A iGreen Energy consulta CPF no cadastro para comparar o nome informado com o titular e reduzir fraude antes da contratação.

Tipspace

Tipspace

A Tipspace usa a consulta de CPF para obter data de nascimento e aplicar a regra de maioridade no acesso à plataforma.

FAQ

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, e-mail nem situação na Receita.

Tem GET individual e lote?

Sim. Consulta individual 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, sem consumir crédito.

Preciso de e-CNPJ ou certificado digital?

Não. A integração é self-serve: crie a conta, copie a API key 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/mês, sem cartão, SLA 95%. Pro: a partir de R$149/mês com 1.000 créditos e R$0,15 de excedente, SLA 99%. Corporativo: sob consulta, SLA 99,9%. Veja /precos.

A CPFHub.io substitui o Serpro?

Não. Serpro e canais oficiais da Receita são a via governamental para situação cadastral ou fonte oficial. A CPFHub.io é uma API comercial complementar — veja a comparação completa abaixo.

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.

Ainda tem dúvidas?

Entre em Contato

Integre a API de CPF
em minutos.

50 consultas grátis. GET individual + lote. Sem e-CNPJ. Sem cartão.

Acesso imediato à API Key e documentação.

WhatsAppFale conosco via WhatsApp