Shipsidekick LogoShipsidekick Docs
API/Orders

List orders

Retrieve a list of orders with pagination and filtering options. Results are filtered to orders the authenticated user has access to.

GET
/orders

Query Parameters

limitinteger

Maximum number of items to return per page

Default: 10Minimum: 1Maximum: 100
pageinteger

Page number for pagination

Default: 1Minimum: 1
searchstring

Search term to filter orders by name, alias, or customer details

cursorstring

Cursor for pagination (alternative to page-based pagination)

sortBystring

Field to sort by (e.g., orderDate, price, name)

sortOrderstring

Order to sort by

Default: "desc"Value in: "asc" | "desc"
includeArchivedboolean

Whether to include archived orders

Default: false
financialStatusstring

Filter orders by financial status

Value in: "authorized" | "expired" | "paid" | "partially-paid" | "partially-refunded" | "pending" | "refunded" | "voided"
fulfillmentStatusstring

Filter orders by fulfillment status

Value in: "scheduled" | "open" | "confirmed" | "on-hold" | "partially-fulfilled" | "fulfilled"
dateRange[from]string

Start date for filtering orders by orderDate

Format: "date"
dateRange[to]string

End date for filtering orders by orderDate

Format: "date"
curl -X GET "https://www.shipsidekick.com/api/v1/orders?limit=10&page=1&search=string&cursor=string&sortBy=string&sortOrder=asc&financialStatus=authorized&fulfillmentStatus=scheduled&dateRange%5Bfrom%5D=2019-08-24&dateRange%5Bto%5D=2019-08-24"

Successful operation

{
  "$ref": "#/components/examples/OrderListExample/value"
}