---
title: "Listar verificaciones de Beneficiary Accounts por lote"
method: GET
path: "/payouts-beneficiary/beneficiary-account/by-batch/{id_beneficiary_batch}"
tags: ["Beneficiary Accounts"]
---

# Listar verificaciones de Beneficiary Accounts por lote

`GET /payouts-beneficiary/beneficiary-account/by-batch/{id_beneficiary_batch}`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/payouts-beneficiary/beneficiary-account/by-batch/{id_beneficiary_batch}`
- Auth: API key in header `x-api-key`

Lista el resultado de la verificación bancaria de todas las Beneficiary Accounts cuyo Beneficiary fue creado en un mismo lote.

El identificador de lote es el `id_beneficiary_batch` que devuelve la creación masiva de Beneficiaries, de modo que esta operación permite seguir el avance de una carga completa sin consultar cuenta por cuenta. Cada elemento informa el estado de la verificación y, cuando corresponde, la razón por la que quedó inválida.

La respuesta viene paginada mediante `page` y `limit`, e incluye el total de verificaciones del lote en `total_count`.

**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_beneficiary_batch` string, uuid, required: Identificador del lote devuelto por la creación masiva de Beneficiaries.

## Query parameters

- `page` integer: Número de página que se quiere obtener; la primera es la 1.
- `limit` integer: Cantidad máxima de elementos por página.

## Response `200`

Página de verificaciones del lote, con el total de verificaciones.

- BeneficiaryAccountsVerificationsByBatchResponse
  - `total_count` integer: Total de verificaciones del lote, no solo las de esta página.
  - `verifications` BeneficiaryAccountVerificationByBatchItem[]: Verificaciones de la página solicitada.
    - `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.
    - `beneficiary_account_external_id` string, required: Identificador de la cuenta en el sistema de origen.
    - `beneficiary_external_id` string, required: Identificador del Beneficiary en el sistema de origen.
    - `beneficiary_name` string, required: Nombre del Beneficiary dueño de la cuenta.
    - `id_beneficiary` string, uuid, required: Identificador del Beneficiary dueño de la cuenta.
    - `id_beneficiary_account` string, uuid, required: Identificador de la Beneficiary Account.
    - `invalid_reason` string, nullable: Motivo por el que la verificación quedó inválida; `null` cuando no lo está.
    - `received_at` string, date-time, nullable: Momento en que se recibió el resultado de la verificación.
    - `requested_at` string, date-time, nullable: Momento en que se solicitó la verificación.
    - `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.
    - `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.

## Other responses

- `422`: Validation Error
- `500`: Error inesperado al procesar la solicitud.

## Changes

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

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