---
title: "List Categories"
method: GET
path: "/api/v1/categories/"
tags: ["Categories"]
---

# List Categories

`GET /api/v1/categories/`

**Rate limit:** 100 requests per minute

## Query parameters

- `query` string, nullable — Search term to filter items by path name
- `parent_category` integer, nullable — ID (integer) of this property
- `page` integer — Page number to retrieve items from.
- `per_page` integer — Number of items per page.

## Response `200`

OK

- GetCategoriesResponseSchema
  - `items` CategorySchema[], required
    - `id` integer, required — ID (integer) of this property
    - `name` string, required — Name of the category
    - `path` string, required — Path of the category for display purposes
    - `parent_id` integer, nullable, required — ID (integer) of this property
    - `material_composition_type` 'textile' | 'non-textile', nullable, required — Material composition type based on mandatory attribute groups
    - `parent` integer, nullable
  - `pagination` Pagination, required
    - `per_page` integer, required — Number of items per page.
    - `page` integer, nullable — Page number (null in cursor mode).
    - `pages` integer, nullable — Total pages (null in cursor mode).
    - `total` integer, nullable — Total count (null in cursor mode).
    - `next` string, nullable — URL for next page (null in cursor mode).
    - `prev` string, nullable — URL for previous page (null in cursor mode).
    - `next_cursor` string, nullable — Opaque cursor for next page when using cursor-based pagination.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `default`

---

[API](https://skmtc.dev/aboutyou/apis/sellers-center-api.md) · [All operations](https://skmtc.dev/aboutyou/apis/sellers-center-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aboutyou/sellers-center-api/revisions/578d18d6e63c/schema)