---
title: "Listar Beneficiary Accounts de un Beneficiary"
method: GET
path: "/payouts-beneficiary/{beneficiary_external_id}/accounts"
tags: ["Beneficiaries"]
---

# Listar Beneficiary Accounts de un Beneficiary

`GET /payouts-beneficiary/{beneficiary_external_id}/accounts`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/payouts-beneficiary/{beneficiary_external_id}/accounts`
- Auth: API key in header `x-api-key`

Lista las Beneficiary Accounts asociadas a un Beneficiary, identificado por su `external_id`.

Devuelve, por cada cuenta, sus datos bancarios, el estado de su verificación y el estado agregado de su flujo de aprobación. Es la vista que permite saber cuáles de las cuentas de un destinatario ya están habilitadas para recibir un pago.

**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

- `beneficiary_external_id` string, required: Identificador del Beneficiary en el sistema de origen (`external_id`).

## Response `200`

Beneficiary Accounts del Beneficiary consultado.

- BeneficiaryAccountByBeneficiaryResponse[]
  - `approval_flows_status` 'INITIALIZING' | 'APPROVED' | 'REJECTED' | 'PENDING' | 'SKIPPED', required: Aggregated approval status for a ``BeneficiaryAccount``. ``INITIALIZING`` is a transient state set at creation time. Downstream consumers must treat ``INITIALIZING`` as blocking (same gating as ``PENDING``/``REJECTED``).
  - `currency_code` string, required: Moneda de la cuenta, en formato ISO.
  - `details` BeneficiaryAccountBankDetailsResponse, required: Bank/account details for PATCH responses.
    - `account_number` string, nullable: Número de la cuenta bancaria. Viene `null` en una cuenta de efectivo, que paga al beneficiario en efectivo y no tiene cuenta bancaria de destino.
    - `bank_code` string, nullable: Código del banco donde está la cuenta. En México son los tres primeros dígitos de la CLABE, así que lo determina el número de cuenta. Viene `null` en una cuenta de efectivo, que no tiene cuenta bancaria de destino.
    - `tokenized_account_number` string, nullable: Token que reemplaza al número de cuenta cuando la cuenta ya fue tokenizada. Viene `null` mientras no lo esté y en una cuenta de efectivo, que no tiene número que tokenizar.
    - `type` 'BANK_ACCOUNT' | 'CASH_ACCOUNT' | 'DEBIT_CARD' | 'CIE_AGREEMENT' | 'INTERNATIONAL_ACCOUNT' | 'BBVA_ACCOUNT' | 'CHECKING_ACCOUNT' | 'VISTA_ACCOUNT' | 'SAVINGS_ACCOUNT', required: Tipo de la cuenta de destino de un Beneficiary Account. Qué valores se aceptan depende del país de la cuenta: en Chile, `CHECKING_ACCOUNT` (cuenta corriente), `VISTA_ACCOUNT` (cuenta vista) y `SAVINGS_ACCOUNT` (cuenta de ahorro); en México, `BANK_ACCOUNT`, cuyo número de cuenta es una CLABE de 18 dígitos; `CIE_AGREEMENT`, un convenio CIE de BBVA de 7 dígitos; `INTERNATIONAL_ACCOUNT`, una cuenta internacional de 20 a 30 dígitos cuyo `bank_code` es el código ABA del banco, de 9 a 11 dígitos; `BBVA_ACCOUNT`, una cuenta BBVA de 10 u 11 dígitos; y `CASH_ACCOUNT` (cuenta de efectivo), que paga al beneficiario en efectivo y por eso no tiene cuenta bancaria de destino. `DEBIT_CARD` quedó como valor heredado y hoy se rechaza en los dos países.
  - `external_id` string, nullable, required: Identificador de la cuenta en el sistema de origen.
  - `gateway_references` object: Identificador que la cuenta ya tiene en cada pasarela de pago, con el nombre de la pasarela como clave. Una cuenta de efectivo recibe el de OXXO Pay al darse de alta, y no se le puede pagar mientras no lo tenga. Viene vacío en una cuenta bancaria.
  - `id_beneficiary_account` string, uuid, required: Identificador de la Beneficiary Account.
  - `verification` BeneficiaryAccountByBeneficiaryVerification: Trimmed verification block for the accounts-by-beneficiary response.
    - `invalid_reason` string, nullable: Motivo por el que la verificación quedó inválida; `null` cuando no lo está.
    - `status` 'PROCESSING' | 'VALIDATED' | 'INVALID' | 'PENDING_VERIFICATION', required: Estado de la verificación bancaria de un Beneficiary Account. La cuenta nace en `PENDING_VERIFICATION`, queda en `PROCESSING` mientras se espera el resultado, y termina en `VALIDATED`, que la habilita para recibir pagos, o en `INVALID`, que la deja rechazada. Editar los datos bancarios la devuelve a `PENDING_VERIFICATION` y reinicia el ciclo. La verificación automática hoy corre solo en México; en Chile la cuenta se queda en `PENDING_VERIFICATION` hasta que un operador la aprueba o rechaza.

## Other responses

- `404`: No existe un Beneficiary con ese `external_id`.
- `422`: Validation Error

## Changes

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

[Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/payouts-beneficiary/:beneficiary_external_id/accounts/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)