---
title: "Get money movements for a plan month"
method: GET
path: "/plans/{plan_id}/months/{month}/money_movements"
tags: ["Money Movements"]
---

# Get money movements for a plan month

`GET /plans/{plan_id}/months/{month}/money_movements`

## Request

- Base URL: `https://api.ynab.com/v1`
- URL: `https://api.ynab.com/v1/plans/{plan_id}/months/{month}/money_movements`
- Auth: HTTP bearer

Returns all money movements for a specific month

## Path parameters

- `plan_id` string, required
- `month` string, date, required

## Response `200`

The list of requested money movements

- MoneyMovementsResponse
  - `data` object, required
    - `money_movements` MoneyMovement[], required
      - `id` string, uuid, required
      - `month` string, date, nullable: The month of the money movement in ISO format (e.g. 2024-01-01)
      - `moved_at` string, date-time, nullable: The date/time the money movement was processed on the server in ISO format (e.g. 2024-01-01T12:00:00Z)
      - `note` string, nullable
      - `money_movement_group_id` string, uuid, nullable: The id of the money movement group this movement belongs to
      - `performed_by_user_id` string, uuid, nullable: The id of the user who performed the money movement
      - `from_category_id` string, uuid, nullable: The id of the category the money was moved from
      - `to_category_id` string, uuid, nullable: The id of the category the money was moved to
      - `amount` integer, required: The amount of the money movement in milliunits format
      - `amount_formatted` string: The money movement amount formatted in the plan's currency format
      - `amount_currency` number, double: The money movement amount as a decimal currency amount
    - `server_knowledge` integer, required: The knowledge of the server

## Other responses

- `404`: No money movements were found

## Changes

- **2026-05-03** `1e4aa027827c`: 3 breaking, 7 warning, 1 info
  - the `data/money_movements/items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `data/money_movements/items/amount` from the response with the `200` status
  - removed the required property `data/money_movements/items/id` from the response with the `200` status
  - removed the optional property `data/money_movements/items/from_category_id` from the response with the `200` status
  - …7 more
- **2026-04-01** `60411c83c141`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ynab/apis/ynab-api-endpoints/changes/plans/:plan_id/months/:month/money_movements/get.md)

---

[API](https://skmtc.dev/ynab/apis/ynab-api-endpoints.md) - [All operations](https://skmtc.dev/ynab/apis/ynab-api-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/ynab/apis/ynab-api-endpoints/revisions/de784d4bf470?raw)