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

O 401 retorna error como string:

JSON

{
  "success": false,
  "error": "API Key não fornecida"
}

JSON

{
  "success": false,
  "error": "API Key inválida"
}

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

Atualizado em 29 de agosto de 2026