Movement is a single change to the balance of an Account. Each Movement records whether money entered (inbound) or left (outbound) the account in direction. The balance field shows 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 | Object type. Always movement. |
account_id | string | Identifier of the account the movement belongs to. |
amount | integer | Change to the account balance, in the smallest currency unit. Use direction to tell whether money entered or left the account. |
balance | integer | Account balance right after the movement, in the smallest currency unit. |
currency | string | Three-letter ISO 4217 currency code. One of CLP or MXN. |
direction | string | Flow of funds relative to the account. One of inbound (money entered) or outbound (money left). |
mode | string | API key mode used to record the movement. One of live or test. |
resource_id | string or null | Identifier of the resource that originated the movement, such as a transfer. null when no resource originated the movement. |
return_pair_id | string or null | Identifier of the other movement in a reversal pair. The identifier appears on both the reversed movement and the corresponding reversal movement, such as a transfer_return. null when the movement is not part of a reversal pair. |
transaction_date | string | ISO 8601 datetime in UTC 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. |