---
title: "Fetch all categories"
method: GET
path: "/categories"
tags: ["categories"]
---

# Fetch all categories

`GET /categories`

This operation shows details for all categories available in Wowza Video.

## Query parameters

- `page` integer
- `per_page` integer
- `query` string — Searches text fields case insensitive and partial. Full matches aren't required. For categories, `name` and `description` are the only searchable fields. Limit to a specific field with a `colon` (`:`). If you have multiple search terms you can use `pipe` (`|`) to separate the search terms. Examples: | Query | Description | | ----- | ----------- | | `query=foo` | Searches name & description field for `foo`. | | `query=foo:description` | Searches description field for `foo`. | | `query=foo\|bar` | Searches name for `foo` and `bar`. A category must match both to be included.|
- `sort_column` 'name'
- `sort_direction` string
- `only_top_level` boolean — Only categories without parent categories will be returned if set to `true`.
- `parent_id` string — Limit search to categories with a specific parent category. When specified, only child categories with the specified parent will be returned.

## Response `200`

Success

- CategoryListModel
  - `categories` CategoryResponse[] — The list of categories.
    - `category` object
      - `id` string — Unique identifier for the category.
      - `name` string — Name of the category.
      - `description` string — A description for the category.
      - `parent_id` string — Identifier to the parent category if one exists. If the category is on top level and no parent exists, the value is an empty string. **Example**: <code>"parent_id": ""</code> If the category is under an existing parent category, the value is the id of the parent category. **Example**: <code>"parent_id": "cb65a918-ad7d-406a-80d8-09c9c8d0dbb"</code> **Note**: When updating a category the parent can be removed by setting `parent_id` to an empty string.
  - `pagination` Pagination
    - `payload_version` number, double — The pagination object version.
    - `total_records` integer — The total number of records.
    - `page` integer — The page number, starting at 1.
    - `per_page` integer — The number of records per page.
    - `total_pages` integer — The total number of pages.
    - `page_first_index` integer — The index of the first record in the response.
    - `page_last_index` integer — The index of the last record in the response.

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/wowza/apis/wowza-video-rest-api-reference-documentation.md) · [All operations](https://skmtc.net/wowza/apis/wowza-video-rest-api-reference-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wowza/wowza-video-rest-api-reference-documentation/revisions/157b6f741f2a/schema)