> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cnpj-api.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Rate Limits

> Understand the API request limits

# Rate Limits

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

## Limits by plan

| Plan  | Limit                  | Reset    | Estimated monthly volume |
| ----- | ---------------------- | -------- | ------------------------ |
| Free  | 5 requests per minute  | 1 minute | \~216,000                |
| Basic | 10 requests per minute | 1 minute | \~432,000                |
| Pro   | 90 requests per minute | 1 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`:

```json theme={null}
{
  "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:

| Endpoint                 | Limit (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](https://cnpj-api.com/en/my-account). For enterprise needs, contact **[suporte@cnpj-api.com](mailto:suporte@cnpj-api.com)**.