# GET /v1/notifications/prefs

Obtenir les préférences de notification

Indique quels événements de notification sont activés sur chaque canal. Leur modification se fait uniquement sur le web (personne connectée). Nécessite la portée `publisher:read` (clé API ou session web). Niveau de limite de débit : `read`.

- Portée requise: `publisher:read`
- Limite débit: `read` — 120 requêtes par fenêtre de 60 s par clé API ou session web

## Paramètres

Aucun paramètre.

## Réponse

```
{ items: { channel: "email" | "telegram" | "webhook" | "webpush"; enabled: boolean; event_type: "payout.upcoming" | "payout.status_changed" | "hold.created" | "hold.decided" | "dispute.replied" | "kyc.status_changed" | "zone.quality_changed" | "ivt.threshold_exceeded" | "zone.traffic_stopped" | "zone.traffic_resumed" | "day.finalized" | "report.daily" | "site.status_changed" | "referral.credited" | "support.replied" | "webhook.endpoint_disabled" | "account.security" | "ping"; locked: boolean }[]; report_hour?: integer }
```

## Erreurs

Les routes soumises à une limite de débit renvoient `RateLimit-Limit`, `RateLimit-Remaining` et `RateLimit-Reset` (secondes avant la fin de la fenêtre) ; une réponse 429 contient aussi `Retry-After`. Ces en-têtes peuvent être absents lorsque le limiteur est temporairement indisponible (les requêtes sont alors acceptées).

| Statut | Sens |
|---|---|
| 401 | Clé API absente, invalide ou révoquée. |
| 403 | La clé n'a pas la portée requise, ou l'opération n'est pas autorisée pour cet acteur. |
| 429 | Limite de débit dépassée ; attendez `Retry-After` secondes. |

Documentation HTML: https://agimone.com/fr/developers/api/#get-notification-prefs
API 2026-10
