---
title: "Retrieve a list of items"
method: GET
path: "/v2/items"
tags: ["Items"]
---

# Retrieve a list of items

`GET /v2/items`

## Request

- Base URL: `https://api.workiz.com/crm/api`
- URL: `https://api.workiz.com/crm/api/v2/items`
- Auth: none declared. Required headers: `Authorization`
- TypeScript: <https://skmtc.dev/workiz/apis/developer-api/docs/v2/items/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 price book and inventory items of the account.

Use `categoryId` to list the items of a single category, `serialId` to fetch a specific set of items, and `type`, `active`, `inventoryManaged` and `booking` to narrow the list further. Category IDs come from the item categories endpoints.

Results are ordered by `serialId` descending - newest first - unless `field` and `order` are given.

## Query parameters

- `pageSize` number
- `page` number
- `field` string
- `order` string
- `serialId` string
- `categoryId` string
- `type` 'service' | 'product' | 'hours' | 'expense' | 'equipment' | 'warranty'
- `active` boolean
- `inventoryManaged` boolean
- `booking` boolean
- `dateProperty` string
- `dateOperator` string
- `date` string

## Headers

- `Authorization` string, required

## Response `200`

A paginated list of items.

- ResponseItemsV2Dto
  - `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` ResponseItemV2Dto[]: A list of items.
    - `id` string: The ID of the item (prefix `ITM-`).
    - `serialId` number: The serial ID of the item.
    - `name` string: The name of the item.
    - `description` string: The description of the item.
    - `model` string: The model number of the item.
    - `category` ResponseGenericItemCategoryV2Dto
      - `id` string: The ID of the item category (prefix `ITC-`).
      - `name` string: The name of the item category.
    - `inventoryManaged` boolean: Whether the inventory of the item is managed.
    - `currentStock` number: The current stock of the item.
    - `cost` number: The cost of the item.
    - `price` number: The price of the item.
    - `type` 'service' | 'product' | 'hours' | 'expense' | 'equipment' | 'warranty': The type of the item.
    - `taxable` boolean: Whether the item is taxable.
    - `discountable` boolean: Whether a discount can be applied to the item.
    - `booking` boolean: Whether the item is available in online booking.
    - `bookingPrice` number, nullable: The online booking price of the item.
    - `active` boolean: Whether the item is active.
    - `imageUrl` string, nullable: The image URL of the item.
    - `updated` string, nullable: The date and time when the item was last updated.

## 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/items/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)