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

> 5 000 requêtes par heure, remises à zéro en haut de chaque heure UTC.

Le quota est de **5 000 requêtes par heure** sur tous les plans. Il est remis à zéro **en haut de chaque heure (UTC)**.

## Headers de quota

Chaque réponse authentifiée porte :

| Header              | Description                                                                  |
| ------------------- | ---------------------------------------------------------------------------- |
| `X-Quota-Limit`     | Votre plafond horaire (5000).                                                |
| `X-Quota-Remaining` | Requêtes restantes pour l'heure UTC en cours.                                |
| `X-Quota-Cost`      | Coût de cette requête (1).                                                   |
| `X-Rows`            | Nombre de lignes renvoyées (informatif, si ≥ 1).                             |
| `Retry-After`       | Uniquement sur les réponses `429` : secondes jusqu'à la prochaine heure UTC. |

## Dépassement (429)

Une fois le quota épuisé, les requêtes renvoient `429` jusqu'au reset :

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

Le header `Retry-After` indique le nombre de secondes avant le reset (haut de l'heure suivante, UTC).

## Suivre votre consommation

Votre consommation de l'heure en cours est aussi affichée dans votre [espace client](https://www.apinn.io/account).