> ## 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 orders across all sellers.
Returns orders platform-wide. Mercur extends the standard Medusa endpoint with `seller_id` and `name` filters.
## Query parameters
Maximum number of records to return.
Number of records to skip.
Field to sort by, prefix with `-` for descending order.
Comma-separated fields to include in the response.
Search term matched against orders.
Filter by order ID(s).
Filter by order status.
Filter to orders belonging to the given seller(s).
Filter by order name(s).
Filter by sales channel IDs.
Filter by region ID(s).
Filter by customer ID(s).
Filter by order total using operators like `$gte` and `$lte`.
Filter by creation date using operators like `$gte` and `$lte`.
Filter by update date using operators like `$gte` and `$lte`.
## Response
The order's ID.
Human-readable order number.
The order's status.
The order's currency.
The order's total amount.
ID of the customer who placed the order.
Creation timestamp.
Last update timestamp.
Total number of matching orders.
Number of records skipped.
Maximum number of records returned.
```bash cURL theme={null}
curl 'http://localhost:9000/admin/orders?seller_id=sel_01HXYZ&limit=20' \
-H 'Authorization: Bearer '
```
```ts JS Client theme={null}
const { orders, count } = await client.admin.orders.query({
seller_id: "sel_01HXYZ",
limit: 20,
})
```
```json 200 theme={null}
{
"orders": [
{
"id": "order_01HXYZ8Q2M4N6P8R0T2V4W6X8Y",
"display_id": 128,
"status": "pending",
"currency_code": "usd",
"total": 4900,
"customer_id": "cus_01HXYZ",
"created_at": "2026-06-01T10:00:00.000Z",
"updated_at": "2026-06-01T10:00:00.000Z"
}
],
"count": 1,
"offset": 0,
"limit": 20
}
```