# GET /v1/holds

List payout holds

Up to 200 publisher holds, newest first, including evidence, decision status, seven-day forfeiture boundary and automatic release time. Active holds already reduce available balance. Requires `publisher:read`. Rate limit tier: `read`.

- Required scope: `publisher:read`
- Rate limit: `read` — 120 requests per 60-second window per API key or web session

## Parameters

No parameters.

## Response

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

## Errors

Rate-limited routes return `RateLimit-Limit`, `RateLimit-Remaining` and `RateLimit-Reset` (seconds until the window ends); a 429 also carries `Retry-After`. The headers may be absent while the limiter is temporarily unavailable (requests are then let through).

| Status | Meaning |
|---|---|
| 401 | Missing, invalid or revoked API key. |
| 403 | The key lacks the required scope, or the operation is not allowed for this actor. |
| 429 | Rate limit exceeded; wait `Retry-After` seconds. |

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