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

# Rate limits

> Limites de requisições por chave e como reagir a respostas 429.

Cada chave de API tem um limite de requisições por minuto (padrão: **60/min**), em janela fixa. Toda resposta autenticada traz o estado atual do seu limite em dois formatos equivalentes — o clássico `X-RateLimit-*` e o padrão IETF `RateLimit-*`:

| Header                                          | Significado                                                        |
| ----------------------------------------------- | ------------------------------------------------------------------ |
| `X-RateLimit-Limit` / `RateLimit-Limit`         | Limite da chave por minuto.                                        |
| `X-RateLimit-Remaining` / `RateLimit-Remaining` | Requisições restantes na janela atual.                             |
| `X-RateLimit-Reset`                             | Momento em que a janela reinicia (Unix timestamp, em segundos).    |
| `RateLimit-Reset`                               | Segundos até a janela reiniciar.                                   |
| `RateLimit-Policy`                              | Política da chave no formato `limite;w=segundos` (ex.: `60;w=60`). |

<Note>
  A informação de rate limit vem nos **headers** da resposta, não no corpo. Em ferramentas como o n8n, habilite a opção de incluir headers na resposta (Response → Include Response Headers and Status) para vê-los.
</Note>

## Quando o limite estoura

A resposta é `429 rate_limit_exceeded`, com o header `Retry-After` indicando em quantos segundos tentar de novo:

```json theme={null}
{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit for this API key exceeded. Retry after the time in the Retry-After header.",
    "request_id": "req_1a2b3c4d-..."
  }
}
```

Trate `429` com backoff: aguarde o `Retry-After` e repita. Em envios, combine com [`Idempotency-Key`](/guias/idempotencia) para repetir sem risco de duplicar mensagens.

## Limite da API vs. limite do WhatsApp

São dois limites diferentes, com códigos distintos:

* `rate_limit_exceeded` — **sua chave** excedeu o limite de requisições da API Superlead.
* `channel_rate_limit` — o **WhatsApp** está limitando o seu número (limites de volume da Meta). Reduza o ritmo de envios para o número; o `Retry-After` da API não se aplica aqui.

<Note>
  Precisa de um limite maior para a sua operação? Fale com o suporte da Superlead.
</Note>