Item Categories

Retrieve an item category

Changed on

Beta: Breaking changes may occur without notice.

Retrieves a single item category by its ID.

get/v2/itemCategories/{id}

Request

Path parameters

idstring required
Example:ITC-9b2c1d4e7f0a3b56

The item category ID (prefix ITC-).

Headers

Authorizationstring required
Example:Bearer <token>

Bearer Token

Response

The requested item category.

idstring

The ID of the item category (prefix ITC-).

namestring

The name of the item category.

descriptionstring

The description of the item category.

parentIdstring nullable

The ID of the parent item category (prefix ITC-). null for a top level category.

activeboolean

Whether the item category is active.

updatedstring nullable

The date and time when the item category was last updated.

createdstring nullable

The date and time when the item category was created.

Example response

{
  "id": "ITC-9b2c1d4e7f0a3b56",
  "name": "Plumbing",
  "description": "Pipes, fittings and plumbing fixtures.",
  "parentId": "ITC-2f5a8c0b6d1e9437",
  "active": true,
  "updated": "2026-01-01 10:00:00",
  "created": "2026-01-01 10:00:00"
}

Changes