## Quotas par plan

| Plan | Requêtes / mois | Clés API | Rétention des logs |
|------|----------------|----------|-------------------|
| **Free** | 100 | 1 | 24 heures |
| **Starter** | 1 000 | 5 | 30 jours |
| **Pro** | 10 000 | 10 | 60 jours |
| **Business** | 100 000 | 10 | 90 jours |

Les quotas se remettent à zéro le **1er de chaque mois à 00:00 UTC**.

## Quand le quota est dépassé

L'API retourne un statut `429` avec un champ `reset_at` indiquant l'heure exacte de remise à zéro :

```json
{
  "error": "quota_exceeded",
  "message": "Monthly quota reached. Upgrade your plan or wait for the reset.",
  "detail": null,
  "reset_at": "2026-04-01T00:00:00Z"
}
```

:::caution[Fail open sur 429]
Ne bloquez jamais un utilisateur parce que votre quota est dépassé. Traitez un `429` comme une erreur réseau — laissez l'utilisateur passer. Votre intégration ne doit jamais dépendre de la disponibilité de Syvel pour autoriser une inscription.
:::

## Rétention des logs

Les logs sont l'historique des requêtes API visibles dans votre dashboard. La rétention varie selon le plan (voir tableau ci-dessus). Les logs plus anciens que la fenêtre de rétention sont automatiquement supprimés et ne peuvent pas être récupérés.

## Changer de plan

Pour augmenter votre quota ou votre limite de clés, changez de plan depuis le [dashboard](https://dashboard.syvel.io/billing).