Autenticação

Todas as requisições à API do CPFHub.io precisam ser autenticadas com uma API Key enviada no header x-api-key.

Obtendo sua API Key

Ao criar sua conta, uma API Key já é gerada automaticamente. Basta acessar app.cpfhub.io/api-keys para visualizá-la e copiá-la a qualquer momento.

Se precisar, você pode gerar uma nova chave nessa mesma página — a chave atual será substituída.

⚠

Guarde sua chave com segurança

Nunca exponha sua API Key em código client-side, repositórios públicos ou logs. Use variáveis de ambiente.

Inclua o header x-api-key em todas as requisições:

bash

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

Todas as requisições devem usar HTTPS:

https://api.cpfhub.io

Requisições via HTTP são redirecionadas para HTTPS automaticamente.

Código	Significado
`401`	API Key ausente ou inválida
`403`	API Key suspensa ou sem permissão

Para detalhes completos sobre todos os erros, veja Códigos de Erro.

Atualizado em 16 de junho de 2026