---
title: "List product categories"
method: GET
path: "/product_categories"
tags: ["Product Categories"]
---

# List product categories

`GET /product_categories`

🔒 Requires: `products:read` scope

## Query parameters

- `parent` string
- `include` 'family' | 'children'
- `page_size` integer
- `after` string

## Response `200`

- object
  - `data` object
    - `categories` ProductCategory[] — The list of product categories, sorted by the full category path alphabetically ascending. In other words, by sorting category path, it will be sorted per category level in alphabetical order.
      - `category_path` ProductCategoryPath[]
        - `id` string, required — Object id of the Product Type in the path.
        - `name` string, required — The Product Type name.
      - `id` string, uuid — The category id
      - `leaf_category` boolean — True if the category does not have any more children (i.e. leaf).
      - `name` string — The name of the category
      - `parent_category_id` string, uuid — The parent category id, or null if its root category.
      - `root_category_id` string, uuid — The category id of the root of the category tree. If category is a root, this will be itself.
  - `page_info` object
    - `has_next` boolean — True if there are more pages available in the next page.
    - `last_seen` string — If there are more results, this is the value to use as "after" to retrieve the next set of results.

---

[API](https://skmtc.dev/lightspeedhq/apis/api-2026-07.md) · [All operations](https://skmtc.dev/lightspeedhq/apis/api-2026-07/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lightspeedhq/api-2026-07/revisions/72d4ceb46dbb/schema)