---
title: "Listar Payout Request Items"
method: GET
path: "/payouts-data-ingestion/payout-request-items/{id_payout_request}"
tags: ["Payout Request Items"]
---

# Listar Payout Request Items

`GET /payouts-data-ingestion/payout-request-items/{id_payout_request}`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/payouts-data-ingestion/payout-request-items/{id_payout_request}`
- Auth: API key in header `x-api-key`

Devuelve los conteos por estado y el detalle fila a fila de un Payout Request ingestado.

Se usa para hacer seguimiento de una carga: `summary` entrega cuántos items quedaron en SUCCESS, FAILED y PREPARING, e `items` entrega una entrada por fila con su `external_id`, su estado y, cuando falló, el motivo en `failure_reason`.

Cada entrada incluye además el detalle del payout que se guardó cuando el lote terminó de ejecutarse: `id_payout`, `amount`, `description`, `due_date`, `expire_at`, `voucher_url`, `is_fraud`, `source_reference`, `beneficiary` y `beneficiary_account`. Esos campos llegan en `null` mientras el lote no termina y en las filas que nunca llegaron a generar un payout.

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

## Path parameters

- `id_payout_request` string, uuid, required: Identificador del Payout Request cuyas filas ingestadas se quieren consultar

## Response `200`

Conteos y detalle por fila del Payout Request

- ListPayoutRequestItemsResponse: Conteos y detalle fila a fila de los Payout Request Items de un Payout Request.
  - `id_payout_request` string, required: Payout Request consultado.
  - `items` PayoutRequestItemSummaryRow[]: Una entrada por fila ingestada, con su estado y el detalle del payout.
    - `amount` number, nullable: Monto del payout; si aún no existe, el monto de la fila ingestada.
    - `beneficiary` PayoutBeneficiary: Datos del beneficiario que recibió el payout, tal como quedaron al ejecutarse el lote.
      - `email` string, nullable: Correo del beneficiario.
      - `external_id` string, nullable: Identificador externo del beneficiario en la integración.
      - `name` string, nullable: Nombre del beneficiario.
      - `phone` string, nullable: Teléfono del beneficiario.
    - `beneficiary_account` PayoutBeneficiaryAccount: Cuenta del beneficiario en la que se depositó el payout.
      - `account_number` string, nullable: Número de cuenta enmascarado.
      - `external_id` string, nullable: Identificador externo de la cuenta en la integración.
    - `description` string, nullable: Descripción con la que quedó registrado el payout.
    - `due_date` string, nullable: Fecha de vencimiento del payout cuando está definida.
    - `expire_at` string, nullable: Fecha de expiración del payout cuando está definida.
    - `external_id` string, nullable: external_id de la fila registrada cuando viene en el payload.
    - `failure_reason` string, nullable: Motivo legible de la falla cuando el estado es FAILED.
    - `id_payout` string, nullable: Identificador del payout generado por esta fila.
    - `is_fraud` boolean, nullable: Indica si el payout quedó marcado como fraude.
    - `source_reference` string, nullable: Referencia de origen del Payout Request al que pertenece la fila.
    - `status` string, required: PREPARING (en curso), FAILED (con error) o SUCCESS (payout completado).
    - `voucher_url` string, nullable: Comprobante del payout ejecutado cuando está disponible.
  - `summary` PayoutRequestItemsSummaryCounts, required: Conteo de Payout Request Items por estado dentro de un Payout Request.
    - `failed_count` integer, required: Items que quedaron con una falla registrada.
    - `preparing_count` integer, required: Items todavía en preparación.
    - `success_count` integer, required: Items cuyo payout se completó.

## Other responses

- `400`: El servicio de configuración respondió con un error de cliente. Su código de estado se propaga sin modificarlo, por lo que cualquier código 4xx de ese servicio puede aparecer aquí.
- `401`: Falta la API key de la organización o no es válida
- `422`: El identificador del Payout Request no tiene formato UUID

## Changes

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

[Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/payouts-data-ingestion/payout-request-items/:id_payout_request/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)