---
title: "Retrieve a list of item categories"
method: GET
path: "/v2/itemCategories"
tags: ["Item Categories"]
---

# Retrieve a list of item categories

`GET /v2/itemCategories`

## Request

- Base URL: `https://api.workiz.com/crm/api`
- URL: `https://api.workiz.com/crm/api/v2/itemCategories`
- Auth: none declared. Required headers: `Authorization`
- TypeScript: <https://skmtc.dev/workiz/apis/developer-api/docs/v2/itemCategories/get.ts> (a function with typed inputs; its response is checked against the schema)

> **Beta:** Breaking changes may occur without notice.

Retrieves a paginated list of the item categories of the account.

Categories are a tree: a top level category has a `null` `parentId`, and `parentId` can be used to list the direct children of a category.

Use the returned category ID with the `categoryId` filter on the items endpoint to list the items of a category.

## Query parameters

- `pageSize` number
- `page` number
- `field` string
- `order` string
- `parentId` string
- `active` boolean
- `dateProperty` string
- `dateOperator` string
- `date` string

## Headers

- `Authorization` string, required

## Response `200`

A paginated list of item categories.

- ResponseItemCategoriesV2Dto
  - `pageSize` number: The maximum number of items returned per page.
  - `page` number: The current page number.
  - `totalResults` number: The total number of results.
  - `hasMore` boolean: Whether there are more results.
  - `data` ResponseItemCategoryV2Dto[]: A list of item categories.
    - `id` string: The ID of the item category (prefix `ITC-`).
    - `name` string: The name of the item category.
    - `description` string: The description of the item category.
    - `parentId` string, nullable: The ID of the parent item category (prefix `ITC-`). `null` for a top level category.
    - `active` boolean: Whether the item category is active.
    - `updated` string, nullable: The date and time when the item category was last updated.
    - `created` string, nullable: The date and time when the item category was created.

## Other responses

- `400`: Invalid query parameters.
- `401`: Missing or invalid authentication token.
- `403`: The API key does not have permission to access this resource.
- `429`: Rate limit exceeded.

## Changes

- **2026-09-29** `a2110eaa32f2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/workiz/apis/developer-api/changes/v2/itemCategories/get.md)

---

[API](https://skmtc.dev/workiz/apis/developer-api.md) - [All operations](https://skmtc.dev/workiz/apis/developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/workiz/apis/developer-api/revisions/fb557783146c?raw)