Movement Object

Monitor transactions and track balance changes in real-time. Currently only available in Mexico.

{
  'id': 'mov_33asX1zyb2iq7bj5BqFhiR9Xt6r',
  'type': 'transfer',
  'direction': 'inbound',
  'resource_id': 'tr_31EsXabIoUCuOF1ddsyJGY7KmrL', 
  'mode': 'test', 
  'amount': 10000,
	'currency': 'MXN',
  'transaction_date': '2025-07-22T23:08:22Z',
  'return_pair_id': None,
  'balance': 52000, 
  'account_id': 'acc_1uRcgub214reUxCsn8sdlL1cmV8N',	
	'object': 'movement'
}

Movement Object

FieldTypeDescription
idstringUnique identifier for the Movement.
typestringType of movement. Options currently only include type transfer.
directionstringEither inbound or outbound depending if the movement it received at or sent from a Fintoc Account.
resource_idstringRelated Fintoc resource that generated the movement.
modestringMode of the API (test or live).
amountintegerThe amount of the movement in the smallest currency unit (e.g. centavos for MXN).
currencystringCurrency of the transfer (in ISO 4217 format, e.g., MXN).
transaction_datestringThe actual date when the movement was initiated (YYYY-MM-DD format).
return_pair_idstringThe ID of a movement that returns or is returned by this movement.
balanceintegerThe resulting amount in the related Account due to this Movement.
account_idstringThe unique identifier of the related Account.
objectstringThe type of the object, which is always movement.