---
title: "Gets a category hierarchy (by category domain) used to render category chips, e.g. on the creator dashboard."
method: GET
path: "/v1/items/categories"
tags: ["Assets", "Metadata"]
---

# Gets a category hierarchy (by category domain) used to render category chips, e.g. on the creator dashboard.

`GET /v1/items/categories`

## Request

- Base URL: `https://itemconfiguration.roblox.com`
- URL: `https://itemconfiguration.roblox.com/v1/items/categories`
- Auth: one of:
  - API key in cookie `.ROBLOSECURITY`
  - API key in header `x-api-key`

## Query parameters

- `categoryDomain` 0 | 1 | 2 | 3

## Response `200`

OK

- RobloxItemConfigurationApiModelsResponseGetCategoriesResponse: Defines the response model for GET v1/items/categories.
  - `categoriesVersionId` string: The version id of the tree the categories were resolved from.
  - `categories` RobloxItemConfigurationApiModelsResponseCategoryNode[]: The root category nodes of the hierarchy.
    - `webStableId` string: The public, tree-stable identifier for the node. Callers pass this back as the category filter; it is expanded to leaf uuids server-side.
    - `id` string: The internal taxonomy node identifier (Synapse branch id or leaf label id).
    - `name` string: The canonical (English) display name of the category.
    - `isPublishable` boolean: Whether the category is publishable by UGC creators.
    - `assetTypeIds` integer[]: Default asset type ids backing this node.
    - `bundleTypeIds` integer[]: Default bundle type ids backing this node.
    - `children` RobloxItemConfigurationApiModelsResponseCategoryNode[]: Child category nodes; empty for leaves.

## Other responses

- `400`: 0: Unknown issues with configuration 19: The provided category domain is not supported
- `401`: 0: Authorization has been denied for this request.
- `404`: 1: Service Unavailable
- `500`: 0: Unknown issues with configuration

## Changes

- **2026-11-13** `e1e00fbc18e5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/roblox/apis/roblox-api/changes/v1/items/categories/get.md)

---

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