---
title: "Changes to Retrieves a list of categories"
method: GET
path: "/categories.json"
---

# Changes to Retrieves a list of categories

`GET /categories.json`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 52 revisions.

- **2026-04-03** `bfe6030ff809`: 1 info
- **2025-10-14** `e90da7406181`: 3 info
- **2024-04-27** `a8a8800fae2b`: 1 info
- **2024-01-27** `2df0ac845943`: 1 info
- **2022-11-24** `1a99c14f514c`: 1 info
- **2022-03-05** `e1108b0434c0`: 1 breaking, 3 warning, 6 info

## Changes

- **2026-04-03** `bfe6030ff809`: 1 info
  - added the required property `category_list/categories/items/topic_title_placeholder` to the response with the `200` status
- **2025-10-14** `e90da7406181`: 3 info
  - added the required property `category_list/categories/items/emoji` to the response with the `200` status
  - added the required property `category_list/categories/items/icon` to the response with the `200` status
  - added the required property `category_list/categories/items/style_type` to the response with the `200` status
- **2024-04-27** `a8a8800fae2b`: 1 info
  - added the required property `category_list/categories/items/subcategory_count` to the response with the `200` status
- **2024-01-27** `2df0ac845943`: 1 info
  - added the required property `category_list/categories/items/uploaded_background_dark` to the response with the `200` status
- **2022-11-24** `1a99c14f514c`: 1 info
  - added the required property `category_list/categories/items/uploaded_logo_dark` to the response with the `200` status
- **2022-03-05** `e1108b0434c0`: 1 breaking, 3 warning, 6 info
  - the response's body type changed from `object` to no type for status `200`
  - removed the optional property `category_list/draft` from the response with the `200` status
  - removed the optional property `category_list/draft_key` from the response with the `200` status
  - removed the optional property `category_list/draft_sequence` from the response with the `200` status
  - api operation id `listCategories` was added
  - added the new optional `query` request parameter `include_subcategories`
  - the response property `category_list` became required for the status `200`
  - the response property `category_list/can_create_category` became required for the status `200`
  - the response property `category_list/can_create_topic` became required for the status `200`
  - the response property `category_list/categories` became required for the status `200`

---

[Operation](https://skmtc.dev/discourse/apis/discourse-api-documentation/docs/categories.json/get.md) - [API](https://skmtc.dev/discourse/apis/discourse-api-documentation.md) - [Page](https://skmtc.dev/discourse/apis/discourse-api-documentation/changes/categories.json/get)