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

# Rate limits

> 5,000 requests per hour, reset at the top of each UTC hour.

The quota is **5,000 requests per hour** on all plans. It is reset **at the top of each hour (UTC)**.

## Quota headers

Every authenticated response carries:

| Header              | Description                                               |
| ------------------- | --------------------------------------------------------- |
| `X-Quota-Limit`     | Your hourly cap (5000).                                   |
| `X-Quota-Remaining` | Requests remaining for the current UTC hour.              |
| `X-Quota-Cost`      | Cost of this request (1).                                 |
| `X-Rows`            | Number of rows returned (informational, if ≥ 1).          |
| `Retry-After`       | Only on `429` responses: seconds until the next UTC hour. |

## Exceeding the limit (429)

Once the quota is exhausted, requests return `429` until the reset:

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

The `Retry-After` header indicates the number of seconds before the reset (top of the next hour, UTC).

## Tracking your usage

Your usage for the current hour is also displayed in your [account area](https://www.apinn.io/account).