Skip to main content
GET
List transfers
v2 · Base URL https://api.fintoc.com/v2

Authorizations

Authorization
string
header
required

Query Parameters

account_id
string

Identifier of the account whose transfers are returned.

account_number_id
string

Identifier of the account number whose transfers are returned.

direction
enum<string>

Direction of the transfers to return. One of inbound or outbound.

Available options:
inbound,
outbound
status
enum<string>[]

Statuses to filter by. One or more of succeeded, rejected, failed, pending, returned, return_pending, and reject_failed. Returns transfers whose status matches any of the values you provide.

Available options:
succeeded,
rejected,
failed,
pending,
returned,
return_pending,
reject_failed
since
string<date-time>

Lower bound for the transaction date. Returns transfers with a transaction_date on or after this ISO 8601 datetime in UTC.

Example:

"2026-01-01T00:00:00Z"

until
string<date-time>

Upper bound for the transaction date. Returns transfers with a transaction_date on or before this ISO 8601 datetime in UTC.

Example:

"2026-03-31T23:59:59Z"

transfer_batch_id
string

Identifier of the transfer batch to filter by. Returns the transfers that belong to this batch.

Example:

"trbatch_2daFu0zqqDtZGJaSi2TGI2Mm1nN"

starting_after
string

Cursor that fetches the next page of transfers. Use the ID of the last transfer from the current page.

Example:

"tr_2rNxBkOrlHoOYsZTyQYhA0o8Ek0"

ending_before
string

Cursor that fetches the previous page of transfers. Use the ID of the first transfer from the current page.

Example:

"tr_2rNxBkOrlHoOYsZTyQYhA0o8Ek0"

limit
integer

Maximum number of transfers to return per page. Ranges from 1 to 300. Defaults to 30.

Example:

50

Response

List of transfers for the current mode.

id
string
required

Unique identifier of the transfer.

Example:

"tr_2daFu0zqqDtZGJaSi2TGI2Mm1nN"

object
any
required

Type of the object. Always transfer.

account_number
object
required
amount
integer
required

Amount of the transfer, in the smallest currency unit. For MXN this is centavos; CLP has no minor unit.

Example:

50000

comment
string | null
required

Comment shown to the counterparty, or null.

Example:

"Payout March"

counterparty
object
required

Details of the counterparty of the transfer.

currency
enum<string>
required

Currency of the transfer. One of CLP, MXN.

Available options:
CLP,
MXN
Example:

"MXN"

direction
enum<string>
required

Whether the transfer is inbound or outbound.

Available options:
inbound,
outbound
Example:

"outbound"

entity
object
required

Entity that owns the account involved in the transfer. For an inbound transfer this is the entity that received the money; for an outbound transfer, the entity that sent it.

metadata
object
required

Set of key-value pairs attached to the transfer.

Example:
mode
enum<string>
required

Whether the transfer is live or test data.

Available options:
live,
test
Example:

"test"

post_date
string<date-time> | null
required

Time the transfer was posted, as an ISO 8601 datetime in UTC, or null.

Example:

null

receipt_url
string | null
required

URL of the transfer receipt, or null.

Example:

null

reference_id
string | null
required

Numeric reference shown in the counterparty statement in Mexico, or null.

Example:

null

return_reason
string | null
required

Reason code when the transfer was returned, or null.

Example:

null

status
enum<string>
required

Lifecycle status of the transfer. One of pending (being processed), succeeded (settled), rejected (rejected before settling), failed (could not be processed), returned (settled, then returned to the sender), return_pending (a return is in progress), or reject_failed (the rejection could not be completed).

Available options:
succeeded,
rejected,
failed,
pending,
returned,
return_pending,
reject_failed
Example:

"succeeded"

tracking_key
string | null
required

Interbank tracking key (clave de rastreo) of the transfer, or null.

Example:

null

transaction_date
string<date-time> | null
required

Time the transfer occurred, as an ISO 8601 datetime in UTC, or null.

Example:

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