---
title: "Item - Get"
method: GET
path: "/item/get"
tags: ["item"]
---

# Item - Get

`GET /item/get`

Retrieve a paginated list of items with optional filtering.

## Query parameters

- `selector` object, required — Query selector object for filtering results
- `limit` number — Max results to return
- `skip` number — Number of results to skip
- `sort` object — Sort fields object, e.g. { "name": 1 }
- `fields` object — Projection fields object, e.g. { "name": 1 }

## Response `200`

Array of items matching the query

- Item[]
  - `_id` string, required — Unique item identifier
  - `name` string — Item name
  - `sku` string — Stock keeping unit
  - `image` string — Image URL
  - `upc` string — Universal product code
  - `listings` ItemListing[] — Store listing connections
    - `store_id` string — Store ID the listing belongs to
    - `item_id` string — Channel listing item ID
    - `variant_id` string — Channel listing variant ID
    - `source_name` string — Source of the listing link
  - `supplies` ItemSupply[] — Supply chain connections
    - `item_id` string — Supply item ID
    - `quantity` number — Quantity per unit
    - `unit` string — Unit of measure
    - `deduction_method` string — Deduction method
  - `custom_fields` ItemCustomField[] — Custom field key-value pairs
    - `field` string, required — Custom field name
    - `value` string, required — Custom field value
  - `barcodes` string[] — Additional barcodes
  - `tags` string[] — Array of tag IDs assigned to this item (ObjectId strings referencing the tag collection)
  - `length` number — Package length
  - `width` number — Package width
  - `height` number — Package height
  - `weight_unit` 'oz' | 'lb' | 'g' | 'kg' — Weight unit
  - `dimensions_unit` 'in' | 'cm' — Dimensions unit
  - `weight` number — Package weight
  - `notes` string — Item notes
  - `fulfillment_sku` string — SKU used for fulfillment
  - `unit` string — Unit of measure
  - `cost` number — Item cost
  - `wholesale` number — Wholesale price
  - `retail` number — Retail price
  - `active` boolean — Whether the item is active
  - `alias_locations` object — Warehouse location assignments (keyed by warehouse ID)

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden. Insufficient permissions.
- `429` — Too many requests. Rate limit exceeded.
- `500` — Internal server error.

## Changes

- **2026-03-02** `fa53dd949b8e` — 2 breaking, 9 info
  - the `query` request parameter `selector` became required
  - for the `query` request parameter `selector`, the type changed from `string` to `object`
  - api operation id `get_item_get` was added
  - for the `query` request parameter `limit`, the format was generalized from `integer` to no format
  - …7 more
- **2024-04-23** `e4bdf6984278` — 2 breaking
  - for the `query` request parameter `fields`, the type changed from `array` to `object`
  - for the `query` request parameter `sort`, the type changed from `number` to `object`, and format from `integer` to no format
- **2024-04-22** `08cd9cfa14dd` — 3 breaking, 3 info
  - for the `query` request parameter `limit`, the type changed from `string` to `number`, and format from no format to `integer`
  - for the `query` request parameter `skip`, the type changed from `string` to `number`, and format from no format to `integer`
  - for the `query` request parameter `sort`, the type changed from `string` to `number`, and format from no format to `integer`
  - for the `query` request parameter `fields`, the type was generalized from `string` to `array`
  - …2 more
- …earlier changes not shown

[Full history](https://skmtc.dev/skulabs/apis/skulabs-api/changes/item/get/get.md)

---

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