Pular para o conteúdo principal

Limites de Uso

Todos os endpoints da API possuem limites de requisições por token. Os limites variam de acordo com o tipo de token utilizado.

Limites por plano

PlanoLimiteResetVolume mensal estimado
Free5 requisições por minuto1 minuto~216.000
Basic10 requisições por minuto1 minuto~432.000
Pro90 requisições por minuto1 minuto~3.888.000
O volume mensal é uma estimativa baseada em uso contínuo: limite × 60 × 24 × 30. Não há limite mensal — apenas o rate limit por minuto é aplicado.

Comportamento ao atingir o limite

Quando o limite de requisições é atingido, a API retorna o status HTTP 429 Too Many Requests:
{
  "error": "Limite de requisições excedido."
}
Aguarde o período de reset antes de fazer novas requisições.

Limites por endpoint

Todos os endpoints possuem o mesmo limite de 5 consultas por minuto para tokens gratuitos:
EndpointLimite (gratuito)
GET /v1/cnpj/{cnpj}5 req/min
GET /v1/logos/{cnpj}5 req/min
GET /v1/simples/{cnpj}5 req/min
GET /v1/cidades/{id}5 req/min

Upgrade

Para aumentar seus limites, faça upgrade do seu plano em Minha Conta. Para necessidades enterprise, entre em contato pelo email [email protected].