Movement object

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"
}
AttributeTypeDescription
idstringUnique identifier for the movement.
objectstringType of the object. Always movement.
account_idstringIdentifier of the account the movement belongs to.
amountintegerAmount of the movement, in the smallest unit of the currency. Use the direction field to tell whether money entered or left the account.
balanceintegerAccount balance right after the movement, in the smallest unit of the currency.
currencystringCurrency of the movement, in ISO 4217 format. One of CLP, MXN.
directionstringWhether money entered (inbound) or left (outbound) the account.
modestringOne of live or test. Movements recorded with a live API key are live; movements recorded with a test API key are test.
resource_idstring or nullIdentifier of the resource that originated the movement, for example a transfer. null when no resource originated the movement.
return_pair_idstring or nullIdentifier 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_datestringISO 8601 datetime in UTC of when Fintoc recorded the movement in the account.
typestringKind of movement. One of transfer, transfer_return (the reversal of a previous transfer), fee, check, compensation, or other.