List transfers
Lists the transfers of your organization in the live or test mode of the API key used. Filter by account_id, account_number_id, direction, status, and transfer_batch_id, or by date range with since and until. The list is paginated. Use the starting_after, ending_before, and limit query parameters to page through it. The Link response header carries the URLs to navigate the pages.
v2 · Base URL https://api.fintoc.com/v2Authorizations
Query Parameters
Identifier of the account whose transfers are returned.
Identifier of the account number whose transfers are returned.
Direction of the transfers to return. One of inbound or outbound.
inbound, outbound 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.
succeeded, rejected, failed, pending, returned, return_pending, reject_failed Lower bound for the transaction date. Returns transfers with a transaction_date on or after this ISO 8601 datetime in UTC.
"2026-01-01T00:00:00Z"
Upper bound for the transaction date. Returns transfers with a transaction_date on or before this ISO 8601 datetime in UTC.
"2026-03-31T23:59:59Z"
Identifier of the transfer batch to filter by. Returns the transfers that belong to this batch.
"trbatch_2daFu0zqqDtZGJaSi2TGI2Mm1nN"
Cursor that fetches the next page of transfers. Use the ID of the last transfer from the current page.
"tr_2rNxBkOrlHoOYsZTyQYhA0o8Ek0"
Cursor that fetches the previous page of transfers. Use the ID of the first transfer from the current page.
"tr_2rNxBkOrlHoOYsZTyQYhA0o8Ek0"
Maximum number of transfers to return per page. Ranges from 1 to 300. Defaults to 30.
50
Response
List of transfers for the current mode.
Unique identifier of the transfer.
"tr_2daFu0zqqDtZGJaSi2TGI2Mm1nN"
Type of the object. Always transfer.
Amount of the transfer, in the smallest currency unit. For MXN this is centavos; CLP has no minor unit.
50000
Comment shown to the counterparty, or null.
"Payout March"
Details of the counterparty of the transfer.
Currency of the transfer. One of CLP, MXN.
CLP, MXN "MXN"
Whether the transfer is inbound or outbound.
inbound, outbound "outbound"
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.
Set of key-value pairs attached to the transfer.
Whether the transfer is live or test data.
live, test "test"
Time the transfer was posted, as an ISO 8601 datetime in UTC, or null.
null
URL of the transfer receipt, or null.
null
Numeric reference shown in the counterparty statement in Mexico, or null.
null
Reason code when the transfer was returned, or null.
null
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).
succeeded, rejected, failed, pending, returned, return_pending, reject_failed "succeeded"
Interbank tracking key (clave de rastreo) of the transfer, or null.
null
Time the transfer occurred, as an ISO 8601 datetime in UTC, or null.
"2026-03-01T12:00:00.000Z"