API de Consulta de CPF | CPFHub.io

# CPFHub.io > API de consulta de CPF brasileiro. Retorna nome completo, gênero e data de nascimento a partir de um número de CPF. ## Conteúdo para LLMs - Referência completa desta API (este arquivo): https://cpfhub.io/llms.txt - Conteúdo completo + índice do blog: https://cpfhub.io/llms-full.txt - Sitemap (todos os URLs publicados): https://cpfhub.io/sitemap.xml - Blog técnico (1000+ artigos sobre CPF, KYC, LGPD): https://cpfhub.io/blog - Qualquer artigo em markdown limpo: https://cpfhub.io/blog/[slug].md CPFHub.io fornece uma REST API simples para verificar identidade de pessoas físicas brasileiras usando o CPF (Cadastro de Pessoas Físicas). A API é usada em fluxos de KYC, onboarding, prevenção de fraudes e preenchimento automático de formulários. ## Endpoints - Base URL: https://api.cpfhub.io - Autenticação: header `x-api-key` - Formato: JSON ### GET /v1/cpf/{cpf} Consulta um CPF e retorna os dados de identidade. **Parâmetros:** - `cpf` (path, obrigatório): CPF com ou sem formatação **Resposta 200:** ```json { "success": true, "data": { "cpf": "123.456.789-09", "name": "Fulano de Tal", "nameUpper": "FULANO DE TAL", "gender": "M", "birthDate": "15/06/1990", "day": 15, "month": 6, "year": 1990 } } ``` **Códigos de erro:** - `400 INVALID_CPF_FORMAT` — formato inválido - `401 INVALID_API_KEY` — chave ausente ou inválida - `403 INSUFFICIENT_CREDITS` — sem créditos - `404 CPF_NOT_FOUND` — CPF não encontrado (não consome crédito) - `422 INVALID_CPF_DIGITS` — dígitos verificadores inválidos - `429 RATE_LIMIT_EXCEEDED` — rate limit excedido, use Retry-After header ## Documentação completa - Início Rápido: https://cpfhub.io/documentacao/inicio - Referência da API: https://cpfhub.io/documentacao/referencia/cpf - Códigos de erro: https://cpfhub.io/documentacao/referencia/codigos - OpenAPI spec (JSON): https://cpfhub.io/openapi.json - OpenAPI spec (YAML): https://cpfhub.io/openapi

openapi: 3.1.0 info: title: CPFHub.io API version: "1.0" description: | REST API for querying Brazilian CPF (Cadastro de Pessoas Físicas) identity data. Returns full name, gender, and date of birth for a given CPF number. Common use cases: KYC, user onboarding, fraud prevention, form auto-fill. Authentication: include your API Key in the `x-api-key` request header. Obtain your key at https://app.cpfhub.io. contact: name: CPFHub.io Support url: https://cpfhu