---
title: "Changes to Get all categories"
method: GET
path: "/plans/{plan_id}/categories"
---

# Changes to Get all categories

`GET /plans/{plan_id}/categories`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 12 revisions.

- **2026-07-12** `2220c3a168a3`: 2 info
- **2026-05-03** `1e4aa027827c`: 9 breaking, 18 warning, 1 info
- **2026-04-01** `60411c83c141`: 1 info

## Changes

- **2026-07-12** `2220c3a168a3`: 2 info
  - added the required property `data/category_groups/items/allOf[#/components/schemas/CategoryGroup]/internal` to the response with the `200` status
  - added the required property `data/category_groups/items/allOf[subschema #2]/categories/items/allOf[#/components/schemas/CategoryBase]/internal` to the response with the `200` status
- **2026-05-03** `1e4aa027827c`: 9 breaking, 18 warning, 1 info
  - the `data/category_groups/items/allOf[subschema #2]/categories/items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `data/category_groups/items/allOf[subschema #2]/categories/items/activity` from the response with the `200` status
  - removed the required property `data/category_groups/items/allOf[subschema #2]/categories/items/balance` from the response with the `200` status
  - removed the required property `data/category_groups/items/allOf[subschema #2]/categories/items/budgeted` from the response with the `200` status
  - removed the required property `data/category_groups/items/allOf[subschema #2]/categories/items/category_group_id` from the response with the `200` status
  - removed the required property `data/category_groups/items/allOf[subschema #2]/categories/items/deleted` from the response with the `200` status
  - removed the required property `data/category_groups/items/allOf[subschema #2]/categories/items/hidden` from the response with the `200` status
  - removed the required property `data/category_groups/items/allOf[subschema #2]/categories/items/id` from the response with the `200` status
  - removed the required property `data/category_groups/items/allOf[subschema #2]/categories/items/name` from the response with the `200` status
  - removed the optional property `data/category_groups/items/allOf[subschema #2]/categories/items/category_group_name` from the response with the `200` status
  - removed the optional property `data/category_groups/items/allOf[subschema #2]/categories/items/goal_cadence` from the response with the `200` status
  - removed the optional property `data/category_groups/items/allOf[subschema #2]/categories/items/goal_cadence_frequency` from the response with the `200` status
  - removed the optional property `data/category_groups/items/allOf[subschema #2]/categories/items/goal_creation_month` from the response with the `200` status
  - removed the optional property `data/category_groups/items/allOf[subschema #2]/categories/items/goal_day` from the response with the `200` status
  - removed the optional property `data/category_groups/items/allOf[subschema #2]/categories/items/goal_months_to_budget` from the response with the `200` status
  - removed the optional property `data/category_groups/items/allOf[subschema #2]/categories/items/goal_needs_whole_amount` from the response with the `200` status
  - removed the optional property `data/category_groups/items/allOf[subschema #2]/categories/items/goal_overall_funded` from the response with the `200` status
  - removed the optional property `data/category_groups/items/allOf[subschema #2]/categories/items/goal_overall_left` from the response with the `200` status
  - removed the optional property `data/category_groups/items/allOf[subschema #2]/categories/items/goal_percentage_complete` from the response with the `200` status
  - removed the optional property `data/category_groups/items/allOf[subschema #2]/categories/items/goal_snoozed_at` from the response with the `200` status
  - removed the optional property `data/category_groups/items/allOf[subschema #2]/categories/items/goal_target` from the response with the `200` status
  - removed the optional property `data/category_groups/items/allOf[subschema #2]/categories/items/goal_target_date` from the response with the `200` status
  - removed the optional property `data/category_groups/items/allOf[subschema #2]/categories/items/goal_target_month` from the response with the `200` status
  - removed the optional property `data/category_groups/items/allOf[subschema #2]/categories/items/goal_type` from the response with the `200` status
  - removed the optional property `data/category_groups/items/allOf[subschema #2]/categories/items/goal_under_funded` from the response with the `200` status
  - removed the optional property `data/category_groups/items/allOf[subschema #2]/categories/items/note` from the response with the `200` status
  - removed the optional property `data/category_groups/items/allOf[subschema #2]/categories/items/original_category_group_id` from the response with the `200` status
  - added `#/components/schemas/CategoryBase, subschema #2` to the `data/category_groups/items/allOf[subschema #2]/categories/items/` response property `allOf` list for the response status `200`
- **2026-04-01** `60411c83c141`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/ynab/apis/ynab-api-endpoints/docs/plans/:plan_id/categories/get.md) - [API](https://skmtc.dev/ynab/apis/ynab-api-endpoints.md) - [Page](https://skmtc.dev/ynab/apis/ynab-api-endpoints/changes/plans/:plan_id/categories/get)