> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mercurjs.com/llms.txt
> Use this file to discover all available pages before exploring further.
# List Orders
> Retrieve a paginated list of the seller's orders.
Returns all non-draft orders belonging to the authenticated seller, with optional filtering by status, customer, region, and more.
## Query parameters
Maximum number of records to return.
Number of records to skip.
Field to sort by, prefix with `-` for descending order.
Comma-separated list of fields to include, prefix with `+`/`-` to add or remove from defaults.
Search term matched against order fields.
Filter by order ID(s).
Filter by order status.
Filter by customer ID(s).
Filter by sales channel ID(s).
Filter by region ID(s).
Filter by currency code(s).
Filter by fulfillment status.
Filter by payment status.
Filter by creation date with operators like `$gte`, `$lte`.
Filter by update date with operators like `$gte`, `$lte`.
## Response
The order's ID.
Human-readable order number.
The order's status.
The customer's email.
The order's currency code.
ID of the order's region.
ID of the customer.
ID of the sales channel.
The order's line items, including variant, product, and offer data.
The order's shipping address.
The order's billing address.
The order's shipping methods.
Payment collections with payments and refunds.
The order's fulfillments.
The order's returns with items and reasons.
Order totals summary.
Custom key-value data.
Creation timestamp.
Last update timestamp.
Cancellation timestamp, if canceled.
Total number of matching orders.
Number of records skipped.
Number of records returned.
```bash cURL theme={null}
curl 'http://localhost:9000/vendor/orders?limit=20&order=-created_at' \
-H 'Authorization: Bearer ' \
-H 'x-seller-id: '
```
```ts JS Client theme={null}
const { orders, count } = await client.vendor.orders.query({
limit: 20,
order: "-created_at",
})
```
```json 200 theme={null}
{
"orders": [
{
"id": "order_01HXYZABCDEF",
"display_id": 42,
"status": "pending",
"email": "jane@example.com",
"currency_code": "usd",
"region_id": "reg_01HXYZABCDEF",
"customer_id": "cus_01HXYZABCDEF",
"sales_channel_id": "sc_01HXYZABCDEF",
"items": [
{
"id": "ordli_01HXYZABCDEF",
"title": "T-Shirt / M",
"quantity": 1,
"unit_price": 2500
}
],
"created_at": "2026-06-01T10:00:00.000Z",
"updated_at": "2026-06-01T10:00:00.000Z",
"canceled_at": null
}
],
"count": 1,
"offset": 0,
"limit": 20
}
```