Skip to main content

​
Rate Limits

All API endpoints have per-token request limits. Limits vary based on the type of token used.

​
Limits by plan

PlanLimitResetEstimated monthly volume
Free5 requests per minute1 minute~216,000
Basic10 requests per minute1 minute~432,000
Pro90 requests per minute1 minute~3,888,000
The monthly volume is an estimate based on continuous usage: limit × 60 × 24 × 30. There is no monthly cap — only the per-minute rate limit is enforced.

​
Behavior when limit is reached

When the request limit is reached, the API returns HTTP status 429 Too Many Requests: 
{
  "error": "Limite de requisições excedido."
}
Wait for the reset period before making new requests.

​
Limits per endpoint

All endpoints have the same limit of 5 queries per minute for free tokens:
EndpointLimit (free)
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

To increase your limits, upgrade your plan at My Account. For enterprise needs, contact [email protected].