---
title: "Retrieve List of Inventory Holds"
method: GET
path: "/v1/integrations/inventory-holds-list"
tags: ["Inventory Holds"]
---

# Retrieve List of Inventory Holds

`GET /v1/integrations/inventory-holds-list`

Returns the inventory holds placed on the account's ASNs, newest first, including the released and cancelled ones.

## General description
- Holds set up for you in the ShipMonk app are listed as well, as long as they are placed on an ASN.
- Products inside each hold are sorted by SKU, then lot number, then expiration date.
- Inventory held for other reasons, for example a quarantine on stock already in the warehouse, is not part of this list.

## Query parameters

- `asn` string, nullable
- `status` 'awaiting_review' | 'held' | 'released' | 'cancelled'
- `page` integer
- `pageSize` integer

## Response `200`

Success

- ShipMonkOMSQuarantineApiResourcePublicApiPaginatedInventoryHoldsOutput
  - `inventory_holds` ShipMonkOMSQuarantineApiResourcePublicApiInventoryHoldOutput[], required — Inventory holds of the account, newest first.
    - `inventory_hold_uuid` string, required — Identifier of the inventory hold. Holds of type `asn` can be updated and released through the API by this identifier.
    - `type` 'asn' | 'on_demand' | 'expiration' | 'audit', required
    - `status` 'awaiting_review' | 'held' | 'released' | 'cancelled', required
    - `name` string, required — Name of the hold, shown in the ShipMonk app.
    - `asn` string, nullable, required — Advance Shipping Notice (ASN) number of the receiving the hold is placed on.
    - `note` string, nullable, required — Note explaining why the inventory is held, or null when none was provided.
    - `created_at` string, date-time, required — When the hold was created.
    - `items` ShipMonkOMSQuarantineApiResourcePublicApiInventoryHoldItemOutput[], required — Products the hold covers, including the ones already released.
      - `sku` string, nullable, required — Stock Keeping Unit (SKU) of the held product, or null when the hold covers every product of the receiving.
      - `lot_number` string, nullable, required — Held lot/batch number, or null when every lot number of the product is held.
      - `expiration_date` string, date, nullable, required — Held expiration date, or null when every expiration date of the product is held.
      - `warehouse` string, nullable, required — Code of the warehouse the hold is limited to, or null when it is not limited to one warehouse.
      - `released` boolean, required — Whether this item has already been released and no longer holds inventory.
  - `paginator` ShipMonkApiOutputPaginatorOutput, required
    - `total` integer, required
    - `pages` integer, required
    - `page` integer, required

## Changes

- **2026-08-28** `9c1d10357491` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/shipmonk/apis/shipmonk-api/changes/v1/integrations/inventory-holds-list/get.md)

---

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