# GET /v1/holds

Liệt kê khoản giữ

Tối đa 200 khoản giữ của nhà xuất bản, mới nhất trước, gồm số tiền, lý do, bằng chứng, ngày có thể thu và ngày tự nhả sau 30 ngày. Khoản giữ đang hoạt động đã trừ khỏi số dư khả dụng. Cần quyền `publisher:read`. Tầng giới hạn tốc độ: `read`.

- Quyền cần có: `publisher:read`
- Giới hạn tốc độ: `read` — 120 yêu cầu mỗi cửa sổ 60 giây cho mỗi API key hoặc phiên web

## Tham số

Không có tham số.

## Phản hồi

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

## Lỗi

Các route có giới hạn tốc độ trả `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset` (số giây tới hết cửa sổ); phản hồi 429 có thêm `Retry-After`. Header có thể vắng khi bộ giới hạn tạm thời không sẵn sàng (khi đó yêu cầu vẫn được cho qua).

| Mã | Ý nghĩa |
|---|---|
| 401 | Thiếu, sai hoặc đã thu hồi API key. |
| 403 | Key thiếu quyền cần có, hoặc thao tác không được phép với tác nhân này. |
| 429 | Vượt giới hạn tốc độ; chờ `Retry-After` giây. |

Tài liệu HTML: https://agimone.com/vi/developers/api/#list-holds
API 2026-10
