Retrieve List of Orders

When no filters are specified, the endpoint will return up to the first 1,000,000 orders, based on selected ordering. If filters are used, this endpoint will return a maximum of 10,000 orders.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
integer
≥ 1
Defaults to 1

1-based page number to return. Defaults to 1.

integer
1 to 100
Defaults to 100

Number of results per page. Defaults to a server-configured value; check the response metadata for the effective size.

string
enum
Defaults to ASC

Sort direction by internal order id: DESC (newest first) or ASC (oldest first).

Allowed:
orderKeys
array of strings | null
Defaults to null

Filter to orders whose order_key matches any value in this list.

orderKeys
orderNumbers
array of strings | null
Defaults to null

Filter to orders whose order_number matches any value in this list.

orderNumbers

Searches orders the same way as the search box in the ShipMonk app. Combined with the other filters by AND.

Matches orders by these searched fields:

  • Order number
  • Reference number
  • Customer order number
  • PO number
  • Other order references, such as release number or job number

How matching works

Each searched field is split into words at spaces and at these characters: # - , :

An order matches when any word in its searched fields starts or ends with the search text. A leading # in the search text is ignored, so #1001 returns the same results as 1001.

Example

Searching 1001 finds orders with these field values:

Field valueOrder type
#1001Standard order
1001-01Replacement order
Merged: 1001, 1002Merge order

Other matched fields

The search also matches tracking numbers, order key, customer name, zip code, customer email and address, serial numbers, freight BOL, load, carrier and shipment tracking numbers, and RMA or return order numbers.

Whitespace

Leading and trailing whitespace is trimmed. A search containing only whitespace is treated as if it was not sent.

storeIds
array of integers | null
Defaults to null

Filter to orders of these store IDs. You can find a store ID in the ShipMonk app under Account Settings > Stores > Store ID, and every order in the response contains its store_id. IDs of stores outside your account are ignored.

storeIds
Order Status | null
Defaults to null

Filter by current order status (see PublicApiOrderStatus enum); omit to return all statuses.

Order Type | null
Defaults to null

Filter by order type (see OrderType enum); omit to return all types.

date-time
Defaults to null

Lower bound (inclusive) on updated_at as an ISO 8601 timestamp; returns orders updated at or after this time.

date-time
Defaults to null

Upper bound (inclusive) on updated_at as an ISO 8601 timestamp; returns orders updated at or before this time.

date-time
Defaults to null

Lower bound (inclusive) on shipped_at as an ISO 8601 timestamp; returns orders shipped at or after this time.

date-time
Defaults to null

Upper bound (inclusive) on shipped_at as an ISO 8601 timestamp; returns orders shipped at or before this time.

Response

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json