# GET /v1/notifications/prefs

Obtener las preferencias de notificación

Qué eventos de notificación están activados en cada canal. Solo se pueden cambiar desde la web (persona con sesión iniciada). Requiere el scope `publisher:read` (clave de API o sesión web). Nivel de límite de uso: `read`.

- Scope requerido: `publisher:read`
- Límite de uso: `read` — 120 solicitudes por ventana de 60 s por clave de API o sesión web

## Parámetros

Sin parámetros.

## Respuesta

```
{ 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 }
```

## Errores

Las rutas con límite de uso devuelven `RateLimit-Limit`, `RateLimit-Remaining` y `RateLimit-Reset` (segundos hasta que termina la ventana); un 429 incluye además `Retry-After`. Los encabezados pueden faltar mientras el limitador no esté disponible temporalmente (en ese caso las solicitudes se dejan pasar).

| Estado | Significado |
|---|---|
| 401 | Clave de API ausente, no válida o revocada. |
| 403 | La clave no tiene el scope requerido, o la operación no está permitida para este actor. |
| 429 | Límite de uso superado; espera los segundos indicados en `Retry-After`. |

Documentación HTML: https://agimone.com/es/developers/api/#get-notification-prefs
API 2026-10
