> ## 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.

# Limites de Uso

> Entenda os limites de requisições da API

# 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            |

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`:

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

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

## Upgrade

Para aumentar seus limites, faça upgrade do seu plano em [Minha Conta](https://cnpj-api.com/my-account). Para necessidades enterprise, entre em contato pelo email **[suporte@cnpj-api.com](mailto:suporte@cnpj-api.com)**.