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

# The Movement object

> A single change to the balance of one of your accounts, recorded whenever money enters or leaves the account.

A `Movement` is a single change to the balance of an `Account`. Each `Movement` records whether money entered (`inbound`) or left (`outbound`) the account in `direction`. The `balance` field shows 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`           | Object type. Always `movement`.                                                                                                                                                                                                          |
| `account_id`       | `string`           | Identifier of the account the movement belongs to.                                                                                                                                                                                       |
| `amount`           | `integer`          | Change to the account balance, in the smallest currency unit. Use `direction` to tell whether money entered or left the account.                                                                                                         |
| `balance`          | `integer`          | Account balance right after the movement, in the smallest currency unit.                                                                                                                                                                 |
| `currency`         | `string`           | Three-letter [ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html). One of `CLP` or `MXN`.                                                                                                                          |
| `direction`        | `string`           | Flow of funds relative to the account. One of `inbound` (money entered) or `outbound` (money left).                                                                                                                                      |
| `mode`             | `string`           | API key mode used to record the movement. One of `live` or `test`.                                                                                                                                                                       |
| `resource_id`      | `string` or `null` | Identifier of the resource that originated the movement, such as a transfer. `null` when no resource originated the movement.                                                                                                            |
| `return_pair_id`   | `string` or `null` | Identifier of the other movement in a reversal pair. The identifier appears on both the reversed movement and the corresponding reversal movement, such as a `transfer_return`. `null` when the movement is not part of a reversal pair. |
| `transaction_date` | `string`           | ISO 8601 datetime in UTC 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`.                                                                                                |