# GET /v1/holds

Lister les retenues de paiement

Jusqu'à 200 retenues de l'éditeur, les plus récentes d'abord, avec preuves, statut de la décision, limite de déchéance de sept jours et heure de libération automatique. Les retenues actives réduisent déjà le solde disponible. Nécessite `publisher:read`. Niveau de limite de débit : `read`.

- Portée requise: `publisher:read`
- Limite débit: `read` — 120 requêtes par fenêtre de 60 s par clé API ou session web

## Paramètres

Aucun paramètre.

## Réponse

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

## Erreurs

Les routes soumises à une limite de débit renvoient `RateLimit-Limit`, `RateLimit-Remaining` et `RateLimit-Reset` (secondes avant la fin de la fenêtre) ; une réponse 429 contient aussi `Retry-After`. Ces en-têtes peuvent être absents lorsque le limiteur est temporairement indisponible (les requêtes sont alors acceptées).

| Statut | Sens |
|---|---|
| 401 | Clé API absente, invalide ou révoquée. |
| 403 | La clé n'a pas la portée requise, ou l'opération n'est pas autorisée pour cet acteur. |
| 429 | Limite de débit dépassée ; attendez `Retry-After` secondes. |

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