# GET /v1/holds

Listar retenções de pagamento

Até 200 retenções do publisher, das mais recentes às mais antigas, incluindo evidências, status da decisão, limite de perda de sete dias e horário de liberação automática. As retenções ativas já reduzem o saldo disponível. Exige `publisher:read`. Nível de limite de taxa: `read`.

- Escopo exigido: `publisher:read`
- Limite de taxa: `read` — 120 requisições por janela de 60 s por chave de API ou sessão web

## Parâmetros

Sem parâmetros.

## Resposta

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

## Erros

As rotas com limite de taxa retornam `RateLimit-Limit`, `RateLimit-Remaining` e `RateLimit-Reset` (segundos até o fim da janela); um 429 também traz `Retry-After`. Os headers podem estar ausentes enquanto o limitador estiver temporariamente indisponível (as requisições passam nesse caso).

| Status | Significado |
|---|---|
| 401 | Chave de API ausente, inválida ou revogada. |
| 403 | A chave não tem o escopo exigido, ou a operação não é permitida para este ator. |
| 429 | Limite de taxa excedido; aguarde `Retry-After` segundos. |

Documentação HTML: https://agimone.com/pt/developers/api/#list-holds
API 2026-10
