> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

```json Movement object theme={null}
{
  "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"
}
```

| Attribute          | Type               | Description                                                                                                                                                                                                           |
| :----------------- | :----------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`               | `string`           | Unique identifier for the movement.                                                                                                                                                                                   |
| `object`           | `string`           | Type of the object. Always `movement`.                                                                                                                                                                                |
| `account_id`       | `string`           | Identifier of the account the movement belongs to.                                                                                                                                                                    |
| `amount`           | `integer`          | 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`          | Account balance right after the movement, in the smallest unit of the currency.                                                                                                                                       |
| `currency`         | `string`           | Currency of the movement, in [ISO 4217 format](https://www.iso.org/iso-4217-currency-codes.html). One of `CLP`, `MXN`.                                                                                                |
| `direction`        | `string`           | Whether money entered (`inbound`) or left (`outbound`) the account.                                                                                                                                                   |
| `mode`             | `string`           | One of `live` or `test`. Movements recorded with a live API key are `live`; movements recorded with a test API key are `test`.                                                                                        |
| `resource_id`      | `string` or `null` | Identifier of the resource that originated the movement, for example a transfer. `null` when no resource originated the movement.                                                                                     |
| `return_pair_id`   | `string` or `null` | 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`           | ISO 8601 datetime in UTC of when Fintoc recorded the movement in the account.                                                                                                                                         |
| `type`             | `string`           | Kind of movement. One of `transfer`, `transfer_return` (the reversal of a previous transfer), `fee`, `check`, `compensation`, or `other`.                                                                             |