Sign in

v1

latestOpenAPI 3.1.02026-07-228956435.8 KB
Movements

List movements

Returns a paginated list of the movements of an account, using the link's link_token to authenticate the request. By default the endpoint returns only confirmed movements; use confirmed_only=false to include every status.

get/accounts/{id}/movements

Path parameters

idstring required

The id of the account that holds the movements to list.

Query parameters

link_tokenstring required
Example:link_Q0xVGPvijElLRMwE_token_FhsFVurz5q5FycHA5xxhTpzX

The link_token of the link that holds the account, obtained when you exchanged the link.

sincestring date

ISO 8601 date. If present, Fintoc returns only movements with post_date on or after since.

untilstring date

ISO 8601 date. If present, Fintoc returns only movements with post_date on or before until.

updated_sincestring date

ISO 8601 date. If present, Fintoc returns only movements created or updated after updated_since.

per_pagestring

Number of movements per page. Defaults to 30. The maximum is 300.

pageinteger

Page number to retrieve. Starts at 1.

confirmed_onlyboolean

Whether to return only confirmed movements. Defaults to true. When false, the endpoint also returns movements with status processing, reversed, and manually_reversed.

Response

Paginated list of movements. The Link and X-Total-Count headers carry the pagination information.

idstring required

Unique identifier of the movement.

object'movement' required

Type of the object. Always movement.

account_idstring required

Identifier of the account the movement belongs to.

amountinteger required

Amount of the movement, in the smallest unit of the currency. Use the direction field to tell whether money entered or left the account.

balanceinteger required

Account balance right after the movement, in the smallest unit of the currency.

currency'CLP' | 'MXN' required

Currency of the movement. One of CLP, MXN.

direction'inbound' | 'outbound' required

Whether money entered (inbound) or left (outbound) the account.

mode'live' | 'test' required

Whether the movement is live or test data.

resource_idstring nullable required

Identifier of the resource that originated the movement, for example, a transfer. null when no resource originated the movement.

return_pair_idstring nullable required

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_datestring date-time required

Date and time Fintoc recorded the movement in the account, as an ISO 8601 datetime in UTC.

type'transfer' | 'transfer_return' | 'fee' | 'check' | 'compensation' | 'other' required

Kind of movement. One of transfer, transfer_return (the reversal of a previous transfer), fee, check, compensation, or other.

Example response

[
  {
    "id": "mov_2daFu0zqqDtZGJaSi2TGI2Mm1nN",
    "account_id": "acc_2rN1bQ8xHvK3mWpYzLd7TfGcRsE",
    "amount": 50000,
    "balance": 1050000,
    "currency": "MXN",
    "direction": "inbound",
    "mode": "test",
    "resource_id": "tr_2sP9cR4yJwM6nXqZaNe8UgHdSt0",
    "transaction_date": "2026-03-01T12:00:00.000Z",
    "type": "transfer"
  }
]