Sign in

v1

latestOpenAPI 3.1.02026-07-228956435.8 KB
Movements

List movements

Lists the movements of one of your accounts for the mode (live or test) of the API key used. Filter by direction and resource_id, or by date range with since and until. The list is paginated. Use the starting_after, ending_before, and limit query parameters to move through the list. The Link response header carries the URLs to navigate the paginated list.

get/accounts/{account_id}/movements

Path parameters

account_idstring required

Unique identifier of the account.

Query parameters

direction'inbound' | 'outbound'

Direction of the movements to return. One of inbound (money entered the account) or outbound (money left the account).

sincestring date-time
Example:2026-01-01T00:00:00Z

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

untilstring date-time
Example:2026-03-31T23:59:59Z

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

resource_idstring
Example:tr_2sP9cR4yJwM6nXqZaNe8UgHdSt0

Identifier of the resource that originated the movement. Returns movements whose resource_id matches, such as a specific transfer.

starting_afterstring
Example:mov_2rNxBkOrlHoOYsZTyQYhA0o8Ek0

Cursor that fetches the next page of movements. Use the ID of the last movement from the current page.

ending_beforestring
Example:mov_2rNxBkOrlHoOYsZTyQYhA0o8Ek0

Cursor that fetches the previous page of movements. Use the ID of the first movement from the current page.

limitinteger
Example:50

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

Response

List of movements for the account.

idstring required

Unique identifier of the movement.

object'movement' required

Type of the object. Always movement.

account_idstring required

Identifier of the account the movement belongs to.

amountinteger required

Amount of the movement, in the smallest unit of the currency. Use the direction field to tell whether money entered or left the account.

balanceinteger required

Account balance right after the movement, in the smallest unit of the currency.

currency'CLP' | 'MXN' required

Currency of the movement. One of CLP, MXN.

direction'inbound' | 'outbound' required

Whether money entered (inbound) or left (outbound) the account.

mode'live' | 'test' required

Whether the movement is live or test data.

resource_idstring nullable required

Identifier of the resource that originated the movement, for example, a transfer. null when no resource originated the movement.

return_pair_idstring nullable required

Identifier of the other movement in a reversal pair, set on both the reversed movement and the movement that reverses it (for example, a transfer_return). null when the movement is not part of a reversal pair.

transaction_datestring date-time required

Date and time Fintoc recorded the movement in the account, as an ISO 8601 datetime in UTC.

type'transfer' | 'transfer_return' | 'fee' | 'check' | 'compensation' | 'other' required

Kind of movement. One of transfer, transfer_return (the reversal of a previous transfer), fee, check, compensation, or other.

Example response

[
  {
    "id": "mov_2daFu0zqqDtZGJaSi2TGI2Mm1nN",
    "account_id": "acc_2rN1bQ8xHvK3mWpYzLd7TfGcRsE",
    "amount": 50000,
    "balance": 1050000,
    "currency": "MXN",
    "direction": "inbound",
    "mode": "test",
    "resource_id": "tr_2sP9cR4yJwM6nXqZaNe8UgHdSt0",
    "transaction_date": "2026-03-01T12:00:00.000Z",
    "type": "transfer"
  }
]