---
title: "List categories"
method: GET
path: "/category"
tags: ["Category"]
---

# List categories

`GET /category`

Get a paginated list of providers categories filter by **type** and other queries

## Query parameters

- `limit` integer
- `offset` integer
- `include` string[]
- `type` string
- `slug` string
- `nrn` string — Nullplatform Resource Name (NRN) representing a hierarchical identifier for nullplatform resources
- `dimensions` string — Dimensions for the query, formatted as key:value pairs separated by commas (e.g., "key1:value1,key2:value2")

## Response `2XX`

Paginated list of categories

- object — Paginated list of categories
  - `paging` object, required
    - `limit` integer, required — Limits the number of results returned
    - `offset` integer, required — Specifies the offset for paginated results
  - `results` Def24[], required
    - `id` string, uuid, required — Unique identifier for the entity represented as a UUID
    - `name` string, required — Name of the category
    - `slug` string, required — Unique slug for the category
    - `icon` string — Icon for the category
    - `description` string — Description of the category
    - `parent_id` string, uuid — Unique identifier for the entity represented as a UUID
    - `category_type_id` string, uuid, required — Unique identifier for the entity represented as a UUID
    - `category_type` object — Category type of the category
      - `id` string, uuid, required — Unique identifier for the entity represented as a UUID
      - `name` string, required — Name of the category type
      - `slug` string, required — Unique slug for the category type
      - `description` string — Description of the category type
    - `parent` Def24 — recursive
    - `sub_categories` Def24[] — Sub categories of the category
    - `created_at` string, date-time, required — Creation timestamp
    - `updated_at` string, date-time, required — Last update timestamp

## Other responses

- `4XX` — Format for representing errors during API interactions
- `5XX` — Format for representing errors during API interactions

---

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