Skip to main content

List Inventory Holds

GET 
/api/v2/inventory/holds

Returns paginated inventory holds (reservations). By default shows active holds (not released, not expired).

Authentication: Requires Bearer token.

Status filter (resolved from filter_groups or filter[status]):

  • active: Not released and not expired (default)
  • released: Released holds
  • expired: Expired holds
  • expiring_soon: Expiring within the next 7 days
  • all: All holds regardless of status

Available sorts: id, quantity, created_at, expires_at, released_at (default: -created_at)

Request​

Responses​

Successful response