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

# Limites de uso

> Os três limites de requisição da API do Pombo, por credencial, por organização e por IP, e como reagir a um 429.

Três contagens independentes, todas em janelas de um minuto. Exceder qualquer uma devolve `429`.

| Contagem        | Limite              |
| --------------- | ------------------- |
| Por credencial  | 50 requisições/min  |
| Por organização | 200 requisições/min |
| Por IP          | 300 requisições/min |

O limite por credencial é o que você encontra primeiro, então planeje a integração por ele. Ele é
aplicado **antes** da autenticação: requisições com segredo inválido também consomem o limite.

## O corpo de um 429

```json theme={null}
{
  "code": "RATE_LIMIT_EXCEEDED",
  "http_code": 429,
  "message": "Too many requests. Please try again later."
}
```

## Como reagir

**Espere o que o `Retry-After` manda esperar.** Toda resposta `429` traz esse cabeçalho, em segundos:
é o tempo exato até a janela virar, e adivinhar um intervalo só chega antes da hora ou tarde demais.
Se o `429` for frequente e não pontual, reduza a taxa de envio na origem.

```
Retry-After: 43
RateLimit-Limit: 200
RateLimit-Remaining: 187
RateLimit-Reset: 43
```

Os cabeçalhos `RateLimit-*` vêm em **toda** resposta, não só no `429`. `RateLimit-Remaining` é
quantas requisições ainda cabem na janela e `RateLimit-Reset` é quantos segundos faltam para ela
virar: dá para desacelerar antes de bater no limite, em vez de reagir depois.

Um detalhe: as três contagens escrevem nos mesmos cabeçalhos, e o valor que chega até você é o da
última a correr, a contagem por organização. Para vigiar o limite por credencial, conte do seu lado.

<Warning>
  **Repetir é seguro em consultas, não em envios.** Em `POST /notifications`, repetir uma chamada
  cuja resposta você não recebeu pode emitir uma segunda notificação à mesma pessoa. Use uma
  [`Idempotency-Key`](/api/idempotencia) ou consulte antes de repetir.
</Warning>

Para notificar muitas pessoas de uma vez, o [envio em massa por planilha](/envios/envio-em-massa) no
painel não passa por estes limites. Precisa de um limite maior na API?
[Fale com o suporte](/ajuda/falar-com-suporte).