Skip to main content

Autenticação

Todas as requisições à API requerem um token de autenticação. Oferecemos tokens gratuitos e pagos.

Tokens gratuitos

Tokens gratuitos estão disponíveis para todos os usuários com limite de 5 consultas por minuto e acesso a todos os endpoints. Para necessidades maiores, tokens pagos oferecem limites superiores e suporte dedicado. Veja Limites de Uso para mais detalhes.

Criando uma conta

Veja a página Criar Conta para instruções de como obter seu token.

Métodos de autenticação

Via parâmetro na URL (recomendado)

A forma preferida de autenticação é enviar o token como parâmetro token na URL:
curl "https://api.cnpj-api.com.br/v1/cnpj/12345678000195?token=SEU_TOKEN"

Via header HTTP

Alternativamente, envie o token no header Authorization:
curl -H "Authorization: Bearer SEU_TOKEN" \
  "https://api.cnpj-api.com.br/v1/cnpj/12345678000195"

Respostas de erro

CódigoDescrição
401Token inválido ou ausente
429Limite de requisições excedido
Ao receber 429, aguarde 1 minuto antes de tentar novamente. Tokens pagos possuem limites superiores.