CNPJAPI

Autenticação

O uso programático da CNPJAPI é autenticado por uma API key enviada no cabeçalho Authorization, no formato Bearer:

Authorization: Bearer cnpj_sua_chave

A chave identifica a sua conta, aplica os limites do seu plano e permite o faturamento por uso.

Chave de testes (sem conta)

Para experimentar antes de criar a conta, use a chave pública de testes:

Authorization: Bearer cnpj_teste_exemplos

Ela responde só a três CNPJs fictícios (nenhum existe na Receita), com respostas de exemplo no formato real da API, sem consumir cota:

CNPJ O que mostra
98765432000198 Empresa com sanção (embargo do IBAMA numa filial), dívida ativa da União, parcelamentos com a Receita e Inscrição Estadual em SP
99999999000191 Empresa sem registros, optante do Simples, com Inscrição Estadual em SP
12ABC34501DE35 Os mesmos registros (sanção, dívida ativa e parcelamentos), no formato alfanumérico que a Receita começou a usar em 2026, sem Inscrição Estadual

Vale em GET /{cnpj} (formato nativo, também com ?incluir=ie) e em GET /consulta/ie/{cnpj}. O exemplo alfanumérico não tem Inscrição Estadual, como na consulta real (422 na rota de IE e cnpj_alfanumerico no ?incluir=ie). Qualquer outro CNPJ, formato ou rota responde 403, e há um limite de 30 chamadas por minuto por IP. Os dados são fictícios e fixos: para consultar empresas reais, crie a sua conta e use a sua chave.

Como gerar a sua API key

  1. Crie sua conta em https://app.cnpjapi.com.br (há um plano gratuito para começar).
  2. No portal, gere a sua API key.
  3. Envie-a no cabeçalho Authorization de cada requisição (veja Consultar um CNPJ).

Trate a API key como um segredo: mantenha-a no servidor (variáveis de ambiente ou cofre de segredos), nunca em código público, repositórios ou aplicativos de front-end.

Consulta web aberta vs. uso programático

A consulta pontual pela web (a busca em https://cnpjapi.com.br) é aberta e sem cadastro - serve para verificar um CNPJ na hora, pelo navegador.

A API key é para o uso programático: é ela que identifica a sua conta, aplica os limites do plano e habilita a integração em sistemas, ERPs, CRMs e fluxos de cadastro.

Erros de autenticação

Status Significado
401 API key ausente ou inválida
403 Sem permissão para o recurso no seu plano

Veja todos os códigos em Erros.