---
title: "Category Detail"
method: GET
path: "/v1/categories/{slug}"
tags: ["v1"]
---

# Category Detail

`GET /v1/categories/{slug}`

Look up a category by slug.

## Path parameters

- `slug` string, required

## Response `200`

Successful Response

- Category — Full category representation used in detail responses.
  - `slug` string, required — URL-friendly slug (e.g. 'sofas')
  - `title` string, required — Human-readable category title
  - `path` CategoryRef[] — Hierarchical path as a structured list, root first; the last entry is this category itself
    - `slug` string, required — URL-friendly slug (e.g. 'sofas')
    - `title` string, required — Human-readable category title
  - `has_children` boolean, required — Whether this category has subcategories
  - `description` string, nullable — Natural-language description of products in this category
  - `children` CategoryRef[] — Direct subcategories only (one level)
    - `slug` string, required — URL-friendly slug (e.g. 'sofas')
    - `title` string, required — Human-readable category title
  - `attributes` CategoryAttribute[] — Structured attributes applicable to this category, with their allowed values. Usable as keys in `SearchFilters.attributes`.
    - `slug` string, required — URL-friendly identifier (e.g. 'color', 'frame-color')
    - `name` string, required — Human-readable attribute name (e.g. 'Color')
    - `values` string[] — Allowed values for this attribute. May be empty when no enumerated value set is defined.

## Other responses

- `401` — Unauthorized - Invalid or missing authentication
- `402` — Payment required
- `404` — Category not found
- `422` — Validation Error
- `500` — Internal Server Error

## Changes

- **2026-05-21** `48ea59b2e819` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/channel3-ai/apis/fastapi/changes/v1/categories/:slug/get.md)

---

[API](https://skmtc.dev/channel3-ai/apis/fastapi.md) · [All operations](https://skmtc.dev/channel3-ai/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/channel3-ai/fastapi/revisions/981d371bd83e/schema)