---
title: "Retrieve an item category"
method: GET
path: "/v2/itemCategories/{id}"
tags: ["Item Categories"]
---

# Retrieve an item category

`GET /v2/itemCategories/{id}`

## Request

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

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

Retrieves a single item category by its ID.

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required

## Response `200`

The requested item category.

- ResponseItemCategoryV2Dto
  - `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

- `401`: Missing or invalid authentication token.
- `403`: The API key does not have permission to access this resource.
- `404`: Item category not found.
- `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/:id/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)