---
title: "View items in a subcategory"
method: GET
path: "/v3/merchants/{mId}/items/{subcategoryitemId}"
tags: ["INVENTORY"]
---

# View items in a subcategory

`GET /v3/merchants/{mId}/items/{subcategoryitemId}`

Retrieves details for an inventory item, primarily to view its associations with categories and subcategories. Include the `expand=categories.items` query parameter in your request to return a detailed `categories` section listing both top-level categories and subcategories linked to the item. You can identify subcategories by their `parentCategory` field. If you omit this parameter, the response does not include category or subcategory data. For more information, see [Manage subcategories](https://docs.clover.com/dev/docs/manage-subcategories).

## Path parameters

- `mId` string, required
- `subcategoryitemId` string, required

## Query parameters

- `expand` 'categories.items'

## Headers

- `User-Agent` string, required

## Response `200`

Successful response. Displays a single inventory item and its category associations.

- object
  - `id` string, required — Unique identifier of the item.
  - `hidden` boolean — Indicates whether the inventory item is hidden on the Register app.
  - `available` boolean — Indicates whether the inventory item is available for sale across all channels, including point-of-sale (POS) devices and customer-facing platforms such as kiosks and merchant online ordering websites.
  - `autoManage` boolean — Indicates whether the inventory item's availability is automatically or manually managed. Values: True - Item availability is automatically managed. False - Item availability is manually managed.
  - `name` string, required — Item name.
  - `alternateName` string — Item alternate name.
  - `code` string — Item product code, such as universal product code (UPC) or European Article Number (EAN).
  - `sku` string — Stock keeping unit (SKU).
  - `price` integer, required — Price of the item. Use price type and merchant currency to determine the actual item price. - For non-VAT merchants who do not pay value-added tax, this field is exclusive of tax. - For VAT merchants, this field is inclusive of tax. Format: Cents
  - `priceType` 'FIXED' | 'VARIABLE' | 'PER_UNIT', required — Price type, such as fixed, variable, or per unit price.
  - `defaultTaxRates` boolean — Indicates whether or not to use the default tax rate.
  - `unitName` string — Unit of measurement for the item, such as pound or meter.
  - `cost` integer — Cost of the item to merchant, as opposed to customer price. Cost of the item to a merchant as compared to the price payable by the customer, for example: wholesale versus retail price.
  - `isRevenue` boolean — Indicates whether this item is counted as revenue, for example: gift cards and donations are not counted as revenue.
  - `stockCount` integer — Deprecated. Use itemStock.quantity.
  - `categories` object — Categories associated with the item.
    - `elements` object[] — List of categories and subcategories associated with the item.
      - `id` string — Unique identifier of the category.
      - `name` string — Category name as it displays in the Register app.
      - `sortOrder` integer — Ascending or descending sort order of the categories.
      - `parentCategory` object — Reference to the parent category of this subcategory.
        - `id` string — Unique identifier of the parent category.
      - `colorCode` string — Hex code of the color assigned to the category and its items. Format: #fff, #ffffff, or #ffffffff.
      - `deleted` boolean — Indicates whether the category can be deleted.
  - `modifiedTime` integer — Time when the item was modified.
  - `deleted` boolean — Whether the inventory item has been deleted.

---

[API](https://skmtc.dev/clover/apis/platform-api.md) · [All operations](https://skmtc.dev/clover/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clover/platform-api/revisions/08da265101a3/schema)