Skip to main content
GET
Get a transfer batch

Autorizaciones

Authorization
string
header
requerido

Parámetros de ruta

id
string
requerido

Unique identifier of the transfer batch to retrieve.

Respuesta

The requested transfer batch.

A group of outbound transfers that you create in one request and approve once from the Dashboard. Fintoc sends the transfers in the batch after you approve the batch. List them with GET /v2/transfers and the transfer_batch_id query parameter.

id
string
requerido

Unique identifier of the transfer batch.

Ejemplo:

"trbatch_2daFu0zqqDtZGJaSi2TGI2Mm1nN"

object
any
requerido

Type of the object. Always transfer_batch.

amount
integer
requerido

Sum of the amounts of the transfers in the batch, in the smallest currency unit. For MXN this is centavos; CLP has no minor unit.

Ejemplo:

150000

authorized_at
string<date-time> | null
requerido

Time the batch was approved from the Dashboard, as an ISO 8601 datetime in UTC, or null.

Ejemplo:

"2026-03-01T12:05:00Z"

created_at
string<date-time>
requerido

Time the batch was created, as an ISO 8601 datetime in UTC.

Ejemplo:

"2026-03-01T12:00:00Z"

currency
enum<string>
requerido

Currency of the transfers in the batch. One of CLP, MXN.

Opciones disponibles:
CLP,
MXN
Ejemplo:

"MXN"

description
string
requerido

Human-readable label for the batch. Up to 40 characters.

Ejemplo:

"Supplier payouts March"

expired_at
string<date-time> | null
requerido

Time the batch expired without approval, as an ISO 8601 datetime in UTC, or null.

Ejemplo:

null

mode
enum<string>
requerido

Whether the batch is live or test data.

Opciones disponibles:
live,
test
Ejemplo:

"test"

partially_succeeded_at
string<date-time> | null
requerido

Time the batch finished after only some transfers succeeded, as an ISO 8601 datetime in UTC, or null.

Ejemplo:

null

rejected_at
string<date-time> | null
requerido

Time the batch was rejected from the Dashboard, as an ISO 8601 datetime in UTC, or null.

Ejemplo:

null

settled_amount
integer
requerido

Sum of the settled_amount of the transfers in the batch, in the smallest currency unit. For MXN this is centavos; CLP has no minor unit.

Ejemplo:

0

status
enum<string>
requerido

Lifecycle status of the batch. One of pending_authorization (waiting for approval in the Dashboard), rejected (rejected in the Dashboard), expired (not approved in time), in_progress (approved, with transfers being sent), succeeded (every transfer succeeded), partially_succeeded (some transfers succeeded), or failed (no transfer succeeded).

Opciones disponibles:
pending_authorization,
rejected,
expired,
in_progress,
succeeded,
partially_succeeded,
failed
Ejemplo:

"in_progress"

succeeded_at
string<date-time> | null
requerido

Time every transfer of the batch succeeded, as an ISO 8601 datetime in UTC, or null.

Ejemplo:

null

succeeded_count
integer
requerido

Number of transfers in the batch that succeeded.

Ejemplo:

0

transfer_count
integer
requerido

Number of transfers in the batch.

Ejemplo:

3