Documentação
A API do CPFHub.io fornece acesso programático a dados de CPF através de endpoints REST simples e seguros.
URL Base
Todas as requisições devem ser feitas para a seguinte URL base:
https://api.cpfhub.ioAutenticação
A API utiliza autenticação baseada em API Key. Você deve incluir sua chave de API em todas as requisições através do header x-api-key.
Como obter sua API Key: Acesse o dashboard em app.cpfhub.io e gere sua chave de API na seção de chaves de API.
123curl -X GET 'https://api.cpfhub.io/cpf/00000000000' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Accept: application/json'Limites de Requisições
A API implementa rate limiting para garantir a qualidade do serviço para todos os usuários. O limite varia de acordo com o plano contratado.
| Plano | Limite |
|---|---|
| Gratuito | 1 requisição a cada 2 segundos |
| Pro | 1 requisição por segundo |
| Corporativo | Personalizado |
Importante: Quando o limite é excedido, a API retorna um status 429 Too Many Requests. Os headers da resposta incluem informações sobre o limite e quando ele será resetado.
Códigos de Resposta
A API utiliza códigos de status HTTP padrão para indicar o sucesso ou falha de uma requisição.
Códigos de Sucesso
| Código | Descrição |
|---|---|
200 | OK - Requisição bem-sucedida |
Códigos de Erro
| Código | Descrição |
|---|---|
400 | Bad Request - Requisição inválida (ex: CPF mal formatado) |
401 | Unauthorized - API Key inválida ou ausente |
404 | Not Found - Recurso não encontrado |
429 | Too Many Requests - Rate limit excedido |
500 | Internal Server Error - Erro no servidor |
503 | Service Unavailable - Serviço temporariamente indisponível |
Dica: Todas as respostas de erro incluem um objeto JSON com detalhes adicionais sobre o erro, incluindo uma mensagem descritiva no campo error.message.
Última atualização: 25/01/2026