---
title: "Verificar BankAccounts en lote público"
method: POST
path: "/bank-account-verification/public-bulk"
tags: ["Validación de Cuenta Clabe"]
---

# Verificar BankAccounts en lote público

`POST /bank-account-verification/public-bulk`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/bank-account-verification/public-bulk`
- Auth: API key in header `x-api-key`

Registra en un solo lote la verificación de varias cuentas CLABE.

Se usa para verificar muchas cuentas de una vez desde la API pública. Cada elemento del lote se procesa igual que una verificación individual (micro transferencia SPEI y contraste opcional de RFC y nombre). Devuelve la referencia del lote y los identificadores de las verificaciones encoladas; el resultado de cada una se resuelve luego de forma asíncrona. Existe un máximo de verificaciones por petición.

## Headers

- `x-account-key` string

## Request body

- PublicBankAccountVerificationBulkPayload: Cuerpo del lote público de BankAccountVerifications.
  - `batch_reference` string, nullable: Referencia con la que agrupar el lote. Si se omite, se genera una con el formato `public-bulk-<uuid>`. Se devuelve en la respuesta y queda disponible como filtro `batch_references` en el listado de verificaciones.
  - `verifications` BankAccountVerificationData[], required: Cuentas a verificar. Cada elemento se procesa igual que una verificación individual. El lote tiene un máximo de elementos por petición; superarlo devuelve 400.
    - `account_number` string, required: CLABE de 18 dígitos de la cuenta a verificar. Es el destino de la micro transferencia SPEI; si no es una CLABE válida la petición se rechaza con 400.
    - `customer_identifier` string, nullable: CURP o RFC del titular declarado. Solo se contrasta contra el identificador que reporta el CEP cuando se envía; si se omite, la verificación confirma la existencia de la cuenta pero no la titularidad. Cuando cualquiera de los dos lados es una CURP (18 caracteres), la comparación se hace sobre los primeros 10, que ambos formatos comparten.
    - `customer_name` string, nullable: Nombre del titular declarado. Solo se contrasta contra el nombre que reporta el CEP cuando se envía, con comparación difusa para tolerar diferencias de formato.
    - `from_inscription` boolean: Marca que la verificación nace de una inscripción de cuenta. Con `true`, si la CLABE ya tiene una verificación previa se reutiliza su resultado en vez de disparar una nueva micro transferencia. Solo aplica en la verificación individual: en el lote las verificaciones recientes se reutilizan siempre.
    - `payment_concept` string, nullable: Concepto con el que viaja la micro transferencia y que ve el titular en su cartola. Si se omite, se usa el configurado para la organización.
    - `reference` string, nullable: Referencia numérica de la micro transferencia SPEI. Si se omite, Toku genera una a partir de la fecha de la operación.
    - `tracking_id` string, nullable: Clave de rastreo SPEI de la micro transferencia. Si se omite, Toku genera una. Queda disponible como filtro en el listado de verificaciones.

## Response `201`

Successful Response

- PublicBulkVerificationResponse: Referencia del lote y los identificadores de las verificaciones encoladas.
  - `batch_reference` string, required: Referencia del lote. Es la enviada en la petición o, si se omite, una generada con el formato `public-bulk-<uuid>`.
  - `ids_bank_account_verification_request` string[], required: Identificadores públicos de las BankAccountVerificationRequests creadas, uno por cada elemento del lote y en el mismo orden.
  - `message` string, required: Confirmación fija de recepción.

## Other responses

- `400`: El lote supera el máximo de verificaciones permitido por petición.
- `401`: La organización no tiene habilitado el módulo de verificación de cuentas bancarias.
- `422`: Validation Error

## Changes

- **2026-11-03** `a6ef070075b1`: 2 breaking, 19 info
  - request body became required
  - the request property `verifications/items/account_number` became required
  - api operation id `verify-bank-account-1` removed and replaced with `verify_public_bulk_bank_accounts`
  - api tag `Validación de Cuenta Clabe` added
  - …17 more

[Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/bank-account-verification/public-bulk/post.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)