CNPJAPI

Limites e planos

O uso da CNPJAPI é limitado por requisições por minuto e por cota mensal, conforme o plano contratado.

  • Requisições por minuto: protege contra picos; controla a taxa de chamadas.
  • Cota mensal: o total de consultas incluídas no seu plano no mês.

Os limites atualizados de cada plano ficam em https://cnpjapi.com.br/#planos.

Ao exceder um limite

Quando qualquer limite é excedido, a API responde:

HTTP/1.1 429 Too Many Requests
Retry-After: 30
  • 429 Too Many Requests indica que você atingiu o limite por minuto ou a cota mensal.
  • O cabeçalho Retry-After informa quantos segundos aguardar antes de tentar de novo.

Boas práticas

  • Respeite o Retry-After: pause pelo tempo indicado antes de repetir a chamada.
  • Tem plano pago? Use o lote: POST /consulta/lote consulta até 20 CNPJs numa única chamada, contando como 1 requisição pro limite por minuto. Sem plano pago, ou pra consultas avulsas, faça uma chamada por vez e distribua no tempo (veja Consultar um CNPJ).
  • Acompanhe o consumo: consulte GET /cota para ver quanto do plano você já usou no mês, sem debitar cota.
  • Trate o 429 como recuperável: não é um erro do seu código; é sinal de ritmo.

Precisa de mais volume?

Se a sua operação consome muitas consultas, compare os planos em https://cnpjapi.com.br/#planos ou fale com a equipe pelo site. Cada plano define os próprios limites por minuto e a cota mensal.