A single change to the balance of one of your accounts, recorded whenever money enters or leaves the account.
The Movement object
A Movement is a single change to an Account's balance. Each Movement records its direction, telling you whether money entered (inbound) or left (outbound) the account, and the resulting balance right after the change.
{
"id": "mov_2daFu0zqqDtZGJaSi2TGI2Mm1nN",
"object": "movement",
"account_id": "acc_2rN1bQ8xHvK3mWpYzLd7TfGcRsE",
"amount": 50000,
"balance": 1050000,
"currency": "MXN",
"direction": "inbound",
"mode": "test",
"resource_id": "tr_2sP9cR4yJwM6nXqZaNe8UgHdSt0",
"return_pair_id": null,
"transaction_date": "2026-03-01T12:00:00.000Z",
"type": "transfer"
}| Attribute | Type | Description |
|---|---|---|
id | string | Unique identifier for the movement. |
object | string | Type of the object. Always movement. |
account_id | string | Identifier of the account the movement belongs to. |
amount | integer | Amount of the movement, in the smallest unit of the currency. Use the direction field to tell whether money entered or left the account. |
balance | integer | Account balance right after the movement, in the smallest unit of the currency. |
currency | string | Currency of the movement, in ISO 4217 format. One of CLP, MXN. |
direction | string | Whether money entered (inbound) or left (outbound) the account. |
mode | string | One of live or test. Movements recorded with a live API key are live; movements recorded with a test API key are test. |
resource_id | string or null | Identifier of the resource that originated the movement, for example a transfer. null when no resource originated the movement. |
return_pair_id | string or null | 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_date | string | ISO 8601 datetime in UTC of when Fintoc recorded the movement in the account. |
type | string | Kind of movement. One of transfer, transfer_return (the reversal of a previous transfer), fee, check, compensation, or other. |