Skip to main content
GET
Error

Authorizations

Authorization
string
header
required

Prefix the value with "ApiKey" to indicate the custom authorization type

Query Parameters

page
integer<int32>

The page number to request (1 based)

Example:

1

size
integer<int32>

The number of results to return in a page

Example:

100

ids
string<uuid>[]

Filter by inventory order IDs

Filter by inventory order IDs

statuses
enum<string>[]

Filter by order statuses (e.g. SUBMITTED, PROCESSING)

Filter by order statuses (e.g. SUBMITTED, PROCESSING)

Available options:
CANCELLED,
COMPLETE,
ORDERED,
PARTIALLY_RECEIVED,
PROCESSING,
RECEIVED,
SHIPPED,
SUBMITTED
warehouseIds
string<uuid>[]

Filter by warehouse IDs

Filter by warehouse IDs

categories
string[]

Filter by product categories (e.g. COMPUTER)

Filter by product categories (e.g. COMPUTER)

brands
string[]

Filter by product brands

Filter by product brands

customerPoNumbers
string[]

Filter by customer PO numbers

Filter by customer PO numbers

friendlyOrderIds
string[]

Filter by exact friendly order IDs (case-insensitive)

Filter by exact friendly order IDs (case-insensitive)

Example:

"ORD-000123"

submittedBy
string<uuid>[]

Filter by person IDs who submitted the order

Filter by person IDs who submitted the order

includeOrdersWithoutSubmitter
boolean

When true, includes orders without a submitter (system-generated). OR'd with submittedBy if both are provided.

reasons
enum<string>[]

Filter by order reasons (e.g. ONE_OFF, RESTOCK)

Filter by order reasons (e.g. ONE_OFF, RESTOCK)

Available options:
ONE_OFF,
RESTOCK
createdDateFrom
string<date>

Filter orders created on or after this date (ISO-8601). If provided, createdDateTo must also be provided.

Example:

"2024-01-01"

createdDateTo
string<date>

Filter orders created on or before this date (ISO-8601). If provided, createdDateFrom must also be provided.

Example:

"2024-12-31"

expectedShipDateFrom
string<date>

Filter orders with expected ship date on or after this date (ISO-8601). If provided, expectedShipDateTo must also be provided.

Example:

"2024-01-01"

expectedShipDateTo
string<date>

Filter orders with expected ship date on or before this date (ISO-8601). If provided, expectedShipDateFrom must also be provided.

Example:

"2024-12-31"

searchString
string

Search string to filter orders

Example:

"laptop"

vendorSku
string[]

Filter by SKU vendor SKUs (MPN).

Filter by SKU vendor SKUs (MPN).

skuId
string<uuid>[]

Filter by SKU IDs.

Filter by SKU IDs.

serialNumber
string[]

Filter by inventory serial numbers.

Filter by inventory serial numbers.

sortBy
string

Field to sort by (createdAt, updatedAt, warehouse, status, submittedBy).

Example:

"createdAt"

sortDirection
string

Sort direction (ASC, DESC).

Example:

"DESC"

Response

Paginated list of inventory orders

id
string<uuid>
required

Order ID

Example:

"123E4567-E89B-12D3-A456-426614174000"

status
enum<string>
required

Order status

Available options:
CANCELLED,
COMPLETE,
ORDERED,
PARTIALLY_RECEIVED,
PROCESSING,
RECEIVED,
SHIPPED,
SUBMITTED
Example:

"PROCESSING"

warehouse
object
required

Warehouse information

reason
enum<string>
required

Order reason

Available options:
ONE_OFF,
RESTOCK
Example:

"ONE_OFF"

inventoryOrderItems
object[]
required

Inventory order items

inventoryOrderShipments
object[]
required

Inventory order shipments

friendlyOrderId
string

Human-readable friendly order ID (order number shown to customers). Null for orders created before this field was populated.

Example:

"ORD-000123"

customerPoNumber
string

Customer PO number

Example:

"PO-12345"

billingType
enum<string>

Billing type

Available options:
SUBSCRIPTION,
PURCHASED
Example:

"SUBSCRIPTION"

submittedBy
object

Person who submitted the order

createdAt
string<date-time>

UTC ISO-8601 timestamp when the inventory order was created.

Example:

"2026-02-26T14:15:22.123Z"

updatedAt
string<date-time>

UTC ISO-8601 timestamp when the inventory order was last updated.

Example:

"2026-03-15T09:00:00.000Z"

expectedShipDate
string<date>

Date by which the inventory order is expected to ship (calendar date, no time component).

Example:

"2026-03-10"