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 token type

Token typeLimitReset
Free5 requests per minute1 minute
PaidHigher limits (per plan)Per plan

​
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
Paid tokens offer higher limits and are recommended for production applications. For more information about paid plans, contact suporte@poupey.com.br.