Skip to main content
GET
List orders

Request

Headers

Query parameters

Request examples

Get all orders

Filter by single status

Filter by multiple statuses

Filter by total range

Filter by date range

Filter by order number

Pagination

Successful response

Error response

Authorizations

Authorization
string
header
required

JWT issued by the Salesive Store API for authenticated shoppers.

x-shop-id
string
header
required

Optional storefront identifier sent as a header to scope responses to a specific shop. Try It requests remember this value once provided.

Headers

x-shop-id
string

Optional identifier that scopes responses to a specific storefront when the referer cannot be inferred.

Query Parameters

status
enum<string>

Filter by order status. Can be specified multiple times.

Available options:
pending,
processing,
paid,
cancelled,
refunded
orderId
integer

Filter by specific order ID.

minTotal
number

Filter orders with total greater than or equal to this value.

maxTotal
number

Filter orders with total less than or equal to this value.

from
string<date-time>

Filter orders created after this date (ISO 8601 format).

to
string<date-time>

Filter orders created before this date (ISO 8601 format).

page
integer
default:1

Page number for pagination (default: 1).

Required range: x >= 1
limit
integer
default:10

Number of items per page (default: 10).

Required range: x >= 1

Response

Orders retrieved successfully.

status
integer
required
success
boolean
required
message
string
required
data
object
required