Erros
A CNPJAPI usa os códigos de status HTTP padrão. Um 200 OK traz os dados do CNPJ em JSON (veja Consultar um CNPJ); os demais indicam o que ajustar.
Códigos de status
| Status | Significado | O que fazer |
|---|---|---|
200 |
Consulta bem-sucedida | Processe o JSON da resposta. |
401 |
API key ausente ou inválida | Confira o cabeçalho Authorization: Bearer (veja Autenticação). |
403 |
Sem permissão para o recurso no seu plano | Verifique o seu plano ou fale com a equipe. |
404 |
CNPJ não encontrado na base pública | Confirme os 14 dígitos; o CNPJ pode não constar na base. |
422 |
Corpo da requisição inválido (ex.: lote sem cnpjs ou com mais de 20 itens) |
Corrija o corpo enviado. |
429 |
Limite por minuto ou cota mensal excedidos | Aguarde o tempo do Retry-After (veja Limites e planos). |
Dicas
- Valide o CNPJ antes de chamar: apenas os 14 dígitos, sem pontuação.
- Trate o
429como recuperável: respeite oRetry-Aftere tente de novo. - Guarde o corpo da resposta em erros: ajuda a diagnosticar
401/403.
Ainda com dúvida? Comece pela visão geral da documentação ou crie sua conta em https://app.cnpjapi.com.br.