cpfhub/api
—Documentação

Comece em 30 segundos.

CPFHub é uma API REST para consulta de CPF. Sem SDK obrigatório, sem callbacks complexos — uma chamada HTTP retorna JSON. Esta página mostra o caminho mais curto entre cadastro e primeira resposta.

Quickstart

Crie uma conta, gere uma chave em /chaves e faça a primeira chamada. Sandbox é gratuito e ilimitado — use para testar antes de promover para produção.

curl https://sandbox.cpfhub.com/v1/cpf/standard \
  -H "Authorization: Bearer sk_sandbox_4f8a..." \
  -H "Content-Type: application/json" \
  -d '{ "cpf": "111.444.777-35" }'

A resposta é determinística:

200 OK
{
  "id": "qry_01HM9Q2K3N4PXYZ",
  "cpf": "111.444.777-35",
  "endpoint": "cpf.standard",
  "data": {
    "name": "Maria Aparecida da Silva",
    "birth_date": "1987-04-12"
  },
  "consulted_at": "2026-04-17T14:32:11Z"
}

Estrutura da API

  • Base URL produçãohttps://api.cpfhub.com/v1
  • Base URL sandboxhttps://sandbox.cpfhub.com/v1
  • FormatoJSON em request e response (UTF-8)
  • AutenticaçãoBearer token no cabeçalho Authorization
  • Versãov1 (estável) — breaking changes via novo prefixo

Endpoints disponíveis

Sete endpoints REST, do mais simples (apenas nome) ao mais completo (com endereços). Todos seguem o mesmo padrão:

POST/v1/cpf/{tipo}

Veja a referência completa de endpoints ou continue em ordem.

Próximos passos

Não há SDK oficial. Use o cliente HTTP da sua linguagem — qualquer um serve. Mantemos os exemplos em cURL, JS e Python sincronizados com a API.