Introdução

A API do CPFHub.io permite consultar dados cadastrais vinculados a um CPF - nome, data de nascimento e gênero - em uma única requisição HTTP autenticada.

O que você pode fazer

Consultar nome completo, data de nascimento e gênero pelo número do CPF
Verificar se um CPF possui dígitos verificadores válidos
Calcular a idade do titular em tempo real (combinando year, month, day)
Integrar verificação de maioridade ao seu fluxo de cadastro ou transação

URL base

Todas as requisições devem usar HTTPS:

https://api.cpfhub.io

Requisições via http:// são redirecionadas automaticamente para HTTPS.

Formato das respostas

Todas as respostas usam Content-Type: application/json.

Sucesso (2xx):

JSON

{
  "data": {
    "cpf": "12345678909",
    "name": "Fulano de Tal",
    "gender": "M",
    "birthDate": "15/06/1990"
  }
}

Erro (4xx / 5xx):

JSON

{
  "error": {
    "code": "CPF_NOT_FOUND",
    "message": "CPF não encontrado na base de dados"
  }
}

Autenticação

Todas as requisições precisam do header x-api-key com sua API Key:

bash

curl "https://api.cpfhub.io/cpf/12345678909" \
  -H "x-api-key: cpfh_sua_api_key_aqui"

Obtenha sua chave gratuitamente em app.cpfhub.io.

Versão da API

A API está na versão v1. O número de versão não faz parte da URL - ele está implícito em todos os endpoints.

Próximos passos

Autenticação - detalhes sobre API Keys e segurança
Consulta de CPF - todos os campos e parâmetros
Limites de Requisições - cotas por plano
Códigos de Resposta - lista completa de erros

Atualizado em 17 de maio de 2026