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

# Quotas e limites

> 5 000 pedidos por hora, reiniciados no início de cada hora UTC.

A quota é de **5 000 pedidos por hora** em todos os planos. É reiniciada **no início de cada hora (UTC)**.

## Headers de quota

Cada resposta autenticada inclui:

| Header              | Descrição                                                    |
| ------------------- | ------------------------------------------------------------ |
| `X-Quota-Limit`     | O seu limite horário (5000).                                 |
| `X-Quota-Remaining` | Pedidos restantes para a hora UTC atual.                     |
| `X-Quota-Cost`      | Custo deste pedido (1).                                      |
| `X-Rows`            | Número de linhas devolvidas (informativo, se ≥ 1).           |
| `Retry-After`       | Apenas nas respostas `429`: segundos até à próxima hora UTC. |

## Excedente (429)

Uma vez esgotada a quota, os pedidos devolvem `429` até ao reset:

```json 429 theme={null}
{
  "detail": "Quota de requêtes horaire dépassé",
  "quota": { "limit": 5000, "used": 5000, "period": "2026-07-16T14" }
}
```

O header `Retry-After` indica o número de segundos até ao reset (início da hora seguinte, UTC).

## Acompanhar o seu consumo

O seu consumo da hora atual também é apresentado no seu [espaço de cliente](https://www.apinn.io/account).