The Movement object
A Movement is a single change to an Account’s balance. Each Movement records itsdirection, telling you whether money entered (inbound) or left (outbound) the account, and the resulting balance right after the change.
Movement object
{
"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. |