Plano Grátis
API de CPF grátis para testar de verdade
50 créditos/mês, sem cartão de crédito. Ideal para MVP e integração. Quando passar do Grátis, o Pro começa em R$19/mês.
O que a API retorna
Nome completo, gênero (M/F) e data de nascimento. Também nameUpper e dia, mês e ano separados.
Sem throttling por segundo
Limite padrão de 30 requisições por minuto na Consulta Simples (cada lote conta como 1) e 5 na Consulta em Tempo Real, ajustável em planos personalizados. O consumo é controlado pelo pool de créditos do mês. SLA de disponibilidade: 95% no Grátis.
Sem crédito no Grátis: 403
No Grátis (sem overage), GET /cpf com saldo zero retorna 403 ("Limite de créditos excedido").
Docs + API key em minutos
Crie a conta, copie a chave em x-api-key e chame GET /cpf/{cpf}. Documentação e exemplos prontos.
Exemplo
Um GET e o JSON volta completo
Header x-api-key. Base https://api.cpfhub.io. Sem versão na URL.
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
}
}FAQ
Perguntas frequentes
Quantas consultas tem o plano Grátis?
O Grátis inclui 50 créditos por mês. A Consulta Simples com CPF encontrado (HTTP 200) custa 1 crédito e a Consulta em Tempo Real custa 1,5 crédito. CPF não encontrado (404) ou com formato ou dígito verificador incorreto (400/422) não consome crédito. Os créditos não acumulam para o mês seguinte.
Precisa de cartão de crédito?
Não. O plano Grátis não exige cartão. Você cria a conta em app.cpfhub.io, gera a API key e começa a consultar.
O que acontece em 0 créditos?
No Grátis (sem overage), GET /cpf retorna 403 com a mensagem "Limite de créditos excedido". No lote, itens sem saldo são marcados como skipped. Nos planos com overage ativo a consulta continua e o excedente entra no ciclo seguinte. Detalhes em /precos.
O Grátis tem SLA?
Sim. SLA de disponibilidade por plano: Grátis 95%, Pro 99%, Corporativo 99,9%. Consulte /precos. O tempo típico da Consulta Simples é ~150 ms e o da Consulta em Tempo Real é cerca de 1 segundo. São referências típicas, não um SLA. Na Consulta em Lote, o tempo depende de quantos CPFs estão no envio, e cada consulta fica na mesma faixa da Consulta Simples.
Ainda tem dúvidas?
Entre em ContatoComece no Grátis
hoje.
50 créditos/mês, sem cartão. API key no dashboard. Quando crescer, o Pro começa em R$19/mês.
Acesso imediato à API Key e documentação.