# GET /v1/holds

Listar retenciones de pago

Hasta 200 retenciones del editor, las más recientes primero, con pruebas, estado de la decisión, límite de pérdida de siete días y hora de liberación automática. Las retenciones activas ya reducen el saldo disponible. Requiere `publisher:read`. Nivel de límite de uso: `read`.

- Scope requerido: `publisher:read`
- Límite de uso: `read` — 120 solicitudes por ventana de 60 s por clave de API o sesión web

## Parámetros

Sin parámetros.

## Respuesta

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

## Errores

Las rutas con límite de uso devuelven `RateLimit-Limit`, `RateLimit-Remaining` y `RateLimit-Reset` (segundos hasta que termina la ventana); un 429 incluye además `Retry-After`. Los encabezados pueden faltar mientras el limitador no esté disponible temporalmente (en ese caso las solicitudes se dejan pasar).

| Estado | Significado |
|---|---|
| 401 | Clave de API ausente, no válida o revocada. |
| 403 | La clave no tiene el scope requerido, o la operación no está permitida para este actor. |
| 429 | Límite de uso superado; espera los segundos indicados en `Retry-After`. |

Documentación HTML: https://agimone.com/es/developers/api/#list-holds
API 2026-10
