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
| Plano | Limite | Reset | Volume mensal estimado |
|---|---|---|---|
| Free | 5 requisições por minuto | 1 minuto | ~216.000 |
| Basic | 10 requisições por minuto | 1 minuto | ~432.000 |
| Pro | 90 requisições por minuto | 1 minuto | ~3.888.000 |
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 HTTP429 Too Many Requests:
Limites por endpoint
Todos os endpoints possuem o mesmo limite de 5 consultas por minuto para tokens gratuitos:| Endpoint | Limite (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 |