---
title: "Get all plan months"
method: GET
path: "/plans/{plan_id}/months"
tags: ["Months"]
---

# Get all plan months

`GET /plans/{plan_id}/months`

Returns all plan months

## Path parameters

- `plan_id` string, required

## Query parameters

- `last_knowledge_of_server` integer

## Response `200`

The list of plan months

- MonthSummariesResponse
  - `data` object, required
    - `months` MonthSummary[], required
      - `month` string, date, required
      - `note` string, nullable
      - `income` integer, required — The total amount of transactions categorized to 'Inflow: Ready to Assign' in the month
      - `budgeted` integer, required — The total amount assigned (budgeted) in the month
      - `activity` integer, required — The total amount of transactions in the month, excluding those categorized to 'Inflow: Ready to Assign'
      - `to_be_budgeted` integer, required — The available amount for 'Ready to Assign'
      - `age_of_money` integer, nullable — The Age of Money as of the month
      - `deleted` boolean, required — Whether or not the month has been deleted. Deleted months will only be included in delta requests.
      - `income_formatted` string — The total income formatted in the plan's currency format
      - `income_currency` number, double — The total income as a decimal currency amount
      - `budgeted_formatted` string — The total amount assigned formatted in the plan's currency format
      - `budgeted_currency` number, double — The total amount assigned as a decimal currency amount
      - `activity_formatted` string — The total activity amount formatted in the plan's currency format
      - `activity_currency` number, double — The total activity amount as a decimal currency amount
      - `to_be_budgeted_formatted` string — The available amount for 'Ready to Assign' formatted in the plan's currency format
      - `to_be_budgeted_currency` number, double — The available amount for 'Ready to Assign' as a decimal currency amount
    - `server_knowledge` integer, required — The knowledge of the server

## Other responses

- `404` — No plan months were found

---

[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-service-production.skmtc.workers.dev/v1/apis/ynab/ynab-api-endpoints/revisions/da7a78345b34/schema)