Limitações
Limitações de uso da API Pública do CNPJ.ws: 3 requisições por minuto por IP e o erro HTTP 429.
A API Pública possui a limitação de atender apenas 3 requisições por minuto de um mesmo IP, entenda que essa limitação é independente ao fato de a consulta ter obtido sucesso ao encontrar o CNPJ. Após ultrapassar esse limite o requisitante terá que aguardar completar os 60 segundos para poder fazer a próxima requisição.
O usuário receberá uma mensagem de erro e HTTP Status Code 429:
{
"status": 429,
"titulo": "Muitas requisições",
"detalhes": "Excedido o limite máximo de 3 consultas por minuto. Liberação ocorrerá em Thu Jun 03 2021 16:15:00 GMT-0300 (Horário Padrão de Brasília)"
}Caso a API identifique um volume anormal de erros — mais de 360 erros HTTP 429 na mesma hora, sinal de que o requisitante continua insistindo mesmo após ser bloqueado — o IP será penalizado e não poderá fazer consultas por 1 hora. Persistindo o comportamento, o bloqueio será renovado por mais 1 hora. Exemplo:
{
"status": 429,
"titulo": "Muitas requisições",
"detalhes": "Excedido o limite máximo de 360 erros HTTP 429 por hora. Liberação ocorrerá em Thu Jun 03 2021 16:15:00 GMT-0300 (Horário Padrão de Brasília)"
}Omissão de dados pessoais
Alguns CNPJs podem retornar o campo observacao informando que parte dos dados foi omitida a pedido do responsável pela empresa. Campos sensíveis (endereço completo, contato, documentos de sócios, faixa etária etc.) vêm como null ou reduzidos, sem remover chaves do JSON. A API Comercial autenticada não aplica essa omissão.