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

# List movements

`GET /accounts/{account_id}/movements`

Lists the movements of one of your accounts for the mode (`live` or `test`) of the API key used. Filter by `direction` and `resource_id`, or by date range with `since` and `until`. The list is paginated. Use the `starting_after`, `ending_before`, and `limit` query parameters to move through the list. The `Link` response header carries the URLs to navigate the paginated list.

## Path parameters

- `account_id` string, required

## Query parameters

- `direction` 'inbound' | 'outbound'
- `since` string, date-time
- `until` string, date-time
- `resource_id` string
- `starting_after` string
- `ending_before` string
- `limit` integer

## Response `200`

List of movements for the account.

- 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

- `401` — Invalid or missing API key.
- `404` — No account with the given ID exists in your organization.

---

[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)