---
title: "List movements"
method: GET
path: "/accounts/{id}/movements"
tags: ["Movements"]
---

# List movements

`GET /accounts/{id}/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.

## Path parameters

- `id` string, required

## Query parameters

- `link_token` string, required
- `since` string, date
- `until` string, date
- `updated_since` string, date
- `per_page` string
- `page` integer
- `confirmed_only` boolean

## Response `200`

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

- Movement[]
  - `id` string, required — Unique identifier of the movement.
  - `object` 'movement', required — Type of the object. Always `movement`.
  - `account_id` string, required — Identifier of the account the movement belongs to.
  - `amount` integer, 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.
  - `balance` integer, 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_id` string, nullable, required — Identifier of the resource that originated the movement, for example, a transfer. `null` when no resource originated the movement.
  - `return_pair_id` string, 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_date` string, 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`.

## Other responses

- `400` — Invalid request: the `link_token` is missing or empty, or a date filter is not a valid ISO 8601 date.
- `401` — Invalid or missing API key.
- `402` — The organization cannot access the movements product: the trial window expired or a payment is pending.
- `403` — The `link_token` is invalid or belongs to a different mode than the API key.
- `404` — The account does not exist or does not belong to the link.

---

[API](https://skmtc.net/fintoc/apis/fintoc-api.md) · [All operations](https://skmtc.net/fintoc/apis/fintoc-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fintoc/fintoc-api/revisions/9dafa63688a3/schema)