---
title: "Retrieves a list of categories"
method: GET
path: "/categories.json"
tags: ["Categories"]
---

# Retrieves a list of categories

`GET /categories.json`

## Query parameters

- `include_subcategories` true

## Response `200`

success response

- object
  - `category_list` object, required
    - `can_create_category` boolean, required
    - `can_create_topic` boolean, required
    - `categories` object[], required
      - `id` integer, required
      - `name` string, required
      - `color` string, required
      - `text_color` string, required
      - `style_type` string, required
      - `emoji` string, nullable, required
      - `icon` string, nullable, required
      - `slug` string, required
      - `topic_count` integer, required
      - `post_count` integer, required
      - `position` integer, required
      - `description` string, nullable, required
      - `description_text` string, nullable, required
      - `description_excerpt` string, nullable, required
      - `topic_url` string, nullable, required
      - `read_restricted` boolean, required
      - `permission` integer, required
      - `notification_level` integer, required
      - `can_edit` boolean, required
      - `topic_template` string, nullable, required
      - `topic_title_placeholder` string, nullable, required
      - `has_children` boolean, required
      - `subcategory_count` integer, nullable, required
      - `sort_order` string, nullable, required
      - `sort_ascending` string, nullable, required
      - `show_subcategory_list` boolean, required
      - `num_featured_topics` integer, required
      - `default_view` string, nullable, required
      - `subcategory_list_style` string, required
      - `default_top_period` string, required
      - `default_list_filter` string, required
      - `minimum_required_tags` integer, required
      - `navigate_to_first_post_after_read` boolean, required
      - `topics_day` integer, required
      - `topics_week` integer, required
      - `topics_month` integer, required
      - `topics_year` integer, required
      - `topics_all_time` integer, required
      - `is_uncategorized` boolean
      - `subcategory_ids` unknown[], required
        - unknown
      - `subcategory_list` unknown[], nullable
        - unknown
      - `uploaded_logo` string, nullable, required
      - `uploaded_logo_dark` string, nullable, required
      - `uploaded_background` string, nullable, required
      - `uploaded_background_dark` string, nullable, required

---

[API](https://skmtc.dev/discourse/apis/discourse-api-documentation.md) · [All operations](https://skmtc.dev/discourse/apis/discourse-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/discourse/discourse-api-documentation/revisions/2fd8fd2d6fd0/schema)