Consulta Simples

Envie o CPF e receba nome, gênero e data de nascimento, a partir da base da CPFHub.io. Custa 1 crédito por CPF encontrado.

Usando Cursor, Lovable, v0 ou outra IA? Copie o prompt da Consulta Simples e cole no seu assistente.

Abrir no Cursor

Usando Cursor, Lovable, v0 ou outra IA? Copie o prompt da Consulta Simples e cole no seu assistente.

Abrir no Cursor

Não é essa? Compare as consultas.

Endpoint

GEThttps://api.cpfhub.io/cpf/{cpf}

Parâmetros

Onde	Nome	Obrigatório	Descrição
Path	`cpf`	Sim	CPF com ou sem formatação: `12345678909` ou `123.456.789-09`
Header	`x-api-key`	Sim	Sua API Key. Veja Autenticação.

Exemplo

Os exemplos leem a chave de CPFHUB_API_KEY, tratam o 404 como resultado normal e usam timeout de 10 s. Outras linguagens: Exemplos por linguagem.

curl --max-time 10 "https://api.cpfhub.io/cpf/12345678909" \
  -H "x-api-key: $CPFHUB_API_KEY"

Resposta

HTTP 200 OK

JSON

{
  "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
  }
}

Campo	Tipo	Descrição
`data.cpf`	`string`	CPF consultado, 11 dígitos sem máscara
`data.name`	`string`	Nome completo. Pode vir em maiúsculas; para comparar, use `nameUpper`
`data.nameUpper`	`string`	Nome completo em maiúsculas
`data.gender`	`"M"` \| `"F"` \| `null`	Gênero. `null` quando a base não tem a informação
`data.birthDate`	`string`	Data de nascimento, `DD/MM/AAAA`
`data.day`, `data.month`, `data.year`	`number`	Componentes da data de nascimento

Erros

Status	Quando acontece	O que fazer
`400`	CPF sem 11 dígitos	Corrija o CPF. Não repita.
`401`	API Key ausente, inválida ou inativa (`error` string)	Confira o header `x-api-key`.
`403`	Créditos esgotados sem overage (`error.message`: `"Limite de créditos excedido"`) ou conta inativa/bloqueada (`error` string)	Recarregue créditos ou fale com o suporte. Não repita.
`404`	CPF não encontrado na base	Resultado normal. Não consome crédito.
`422`	Dígito verificador inválido	Corrija o CPF. Não repita.
`429`	Limite por minuto excedido (30/min no padrão)	Espere os segundos do header `Retry-After`. Não consome crédito.
`500`, `503`	Falha passageira	Repita com espera crescente (2 s, 4 s, 8 s). Não consome crédito.

Formato do erro, retentativas e como testar sem gastar créditos: Códigos de Erro. Limite por minuto e créditos: Limites de Uso.

Detalhes

Custo: 1 crédito por CPF encontrado (200). Alguns planos têm custo próprio: consulte o do seu plano no dashboard.
Tempo de resposta: tempo típico de ~150 ms (não é um SLA). Use timeout de cerca de 10 s.
Timeout do cliente: a consulta pode ter sido concluída e cobrada no servidor. Repetir cobra de novo.
Dados de exemplo: o CPF 12345678909 e os dados acima são fictícios.

Atualizado em 4 de outubro de 2026