# GET /v1/holds

Daftar penahanan pembayaran

Hingga 200 penahanan publisher, terbaru lebih dulu, termasuk bukti, status keputusan, batas hangus tujuh hari, dan waktu pelepasan otomatis. Penahanan aktif sudah mengurangi saldo yang tersedia. Memerlukan `publisher:read`. Tingkat batas laju: `read`.

- Scope wajib: `publisher:read`
- Batas laju: `read` — 120 permintaan per jendela 60 detik per kunci API atau sesi web

## Parameter

Tanpa parameter.

## Respons

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

## Error

Rute yang dibatasi lajunya mengembalikan `RateLimit-Limit`, `RateLimit-Remaining`, dan `RateLimit-Reset` (detik hingga jendela berakhir); respons 429 juga menyertakan `Retry-After`. Header ini bisa tidak ada saat pembatas laju sementara tidak tersedia (permintaan lalu diteruskan).

| Status | Arti |
|---|---|
| 401 | Kunci API tidak ada, tidak valid, atau sudah dicabut. |
| 403 | Kunci tidak memiliki scope yang diperlukan, atau operasi tidak diizinkan untuk aktor ini. |
| 429 | Batas laju terlampaui; tunggu `Retry-After` detik. |

Dokumentasi HTML: https://agimone.com/id/developers/api/#list-holds
API 2026-10
