---
title: "List Payouts"
method: GET
path: "/payouts-payout/payouts"
tags: ["Payout"]
---

# List Payouts

`GET /payouts-payout/payouts`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/payouts-payout/payouts`
- Auth: API key in header `x-api-key`

List payouts with pagination.

**Límite de tasa:** 1000 solicitudes por hora. Al superarlo, la API responde `429`. Ver [Límites de tasa](/reference/limites-de-tasa).

## Query parameters

- `page` integer
- `page_size` integer
- `id_payout_request` string, uuid, nullable
- `source_reference` string, nullable
- `id_payout_batch` string, uuid, nullable
- `assigned_to_batch` boolean, nullable

## Response `200`

Successful Response

- PaginatedPayoutsResponse
  - `payouts` PayoutResponse[], required
    - `amount` number, required
    - `beneficiary` BeneficiaryInfo, required
      - `email` string, nullable
      - `external_id` string, nullable
      - `id` string, uuid, required
      - `name` string, required
    - `beneficiary_account` BeneficiaryAccountInfo, required
      - `account_number` string, nullable: Account number of the beneficiary account. Null on a cash account, which has none.
      - `external_id` string, nullable
      - `id` string, uuid, required
    - `description` string, nullable
    - `external_id` string, nullable
    - `failure_reason` string, nullable, required
    - `id_payout` string, uuid, required
    - `id_payout_batch` string, uuid, nullable
    - `status` 'CREATED' | 'READY_TO_EXECUTE' | 'IN_PROGRESS' | 'SUCCESS' | 'FAILED' | 'RISK_REJECTED' | 'REJECTED' | 'EXPIRED' | 'NOT_COLLECTED' | 'CANCELLED', required
    - `voucher` Voucher
      - `is_available` boolean
      - `type` 'CEP', required
      - `url` string, required
  - `total_count` integer, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-03** `a6ef070075b1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/payouts-payout/payouts/get.md)

---

[API](https://skmtc.dev/trytoku/apis/toku-api.md) - [All operations](https://skmtc.dev/trytoku/apis/toku-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytoku/apis/toku-api/revisions/a6ef070075b1?raw)