---
title: "Retrieve an item"
method: GET
path: "/v2/items/{id}"
tags: ["Items"]
---

# Retrieve an item

`GET /v2/items/{id}`

## Request

- Base URL: `https://api.workiz.com/crm/api`
- URL: `https://api.workiz.com/crm/api/v2/items/{id}`
- Auth: none declared. Required headers: `Authorization`
- TypeScript: <https://skmtc.dev/workiz/apis/developer-api/docs/v2/items/: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 by its ID.

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required

## Response `200`

The requested item.

- ResponseOneItemV2Dto
  - `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.
  - `customFields` ResponseItemCustomFieldV2Dto[]: A list of the account's item custom fields, with this item's value for each.
    - `id` string: The ID of the custom field (prefix `ICF-`).
    - `name` string: The name of the custom field.
    - `value` string: The value of the custom field for this item. An empty string when the item has no value for it.

## Other responses

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