# GET /v1/holds

Список удержаний выплат

До 200 удержаний паблишера, сначала новые, с доказательствами, статусом решения, границей семидневного срока обращения в доход и временем автоматического снятия. Активные удержания уже уменьшают доступный баланс. Требуется `publisher:read`. Уровень лимита: `read`.

- Требуемая область: `publisher:read`
- Лимит запросов: `read` — 120 запросов за окно в 60 с на ключ API или веб-сессию

## Параметры

Нет параметров.

## Ответ

```
{ amount: string; auto_release_at: string; created_at: string; date_from: string; date_to: string; decided_at: string | null; decision_note: string | null; evidence: string; evidence_data: { cap: string; ivt: object | null; network_report_ref: string | null; reported_deduction: string | null; revenue_publisher: string; revshare_pct: number; suspect_pct: number | null }; forfeit_not_before: string; id: integer; original_amount: string; reason_code: "ivt_suspected" | "network_clawback_pending" | "policy_violation"; status: "active" | "released" | "forfeited"; zone_id: integer | null; zone_name: string | null }[]
```

## Ошибки

Маршруты с ограничением частоты возвращают `RateLimit-Limit`, `RateLimit-Remaining` и `RateLimit-Reset` (секунд до конца окна); ответ 429 также содержит `Retry-After`. Заголовки могут отсутствовать, пока ограничитель временно недоступен (запросы тогда пропускаются).

| Статус | Смысл |
|---|---|
| 401 | Ключ API отсутствует, недействителен или отозван. |
| 403 | У ключа нет требуемой области, либо операция недоступна для этого субъекта. |
| 429 | Лимит запросов превышен; подождите `Retry-After` секунд. |

HTML-документация: https://agimone.com/ru/developers/api/#list-holds
API 2026-10
