# GET /v1/notifications/prefs

Obter preferências de notificação

Quais eventos de notificação estão ativados em cada canal. A alteração é somente pela web (pessoa conectada). Exige o escopo `publisher:read` (chave de API ou sessão web). Nível de limite de taxa: `read`.

- Escopo exigido: `publisher:read`
- Limite de taxa: `read` — 120 requisições por janela de 60 s por chave de API ou sessão web

## Parâmetros

Sem parâmetros.

## Resposta

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

## Erros

As rotas com limite de taxa retornam `RateLimit-Limit`, `RateLimit-Remaining` e `RateLimit-Reset` (segundos até o fim da janela); um 429 também traz `Retry-After`. Os headers podem estar ausentes enquanto o limitador estiver temporariamente indisponível (as requisições passam nesse caso).

| Status | Significado |
|---|---|
| 401 | Chave de API ausente, inválida ou revogada. |
| 403 | A chave não tem o escopo exigido, ou a operação não é permitida para este ator. |
| 429 | Limite de taxa excedido; aguarde `Retry-After` segundos. |

Documentação HTML: https://agimone.com/pt/developers/api/#get-notification-prefs
API 2026-10
