# GET /v1/payouts

Listar pagos

Lista las solicitudes de pago del editor y su estado. Requiere el scope `publisher:read` (clave de API o sesión web). 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; decided_at: string | null; id: integer; method: "paypal" | "usdt" | "bank"; notes: string | null; paid_at: string | null; requested_at: string; status: "requested" | "approved" | "paid" | "rejected"; tx_ref: 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-payouts
API 2026-10
