> ## 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

**limit** `number` (default: 15)

Maximum number of records to return.

**offset** `number` (default: 0)

Number of records to skip.

**order** `string`

Field to sort by, prefix with `-` for descending order.

**fields** `string`

Comma-separated fields to include in the response.

**q** `string`

Search term matched against orders.

**id** `string | string[]`

Filter by order ID(s).

**status** `string | string[]`

Filter by order status.

**seller\_id** `string | string[]`

Filter to orders belonging to the given seller(s).

**name** `string | string[]`

Filter by order name(s).

**sales\_channel\_id** `string[]`

Filter by sales channel IDs.

**region\_id** `string | string[]`

Filter by region ID(s).

**customer\_id** `string | string[]`

Filter by customer ID(s).

**total** `object`

Filter by order total using operators like `$gte` and `$lte`.

**created\_at** `object`

Filter by creation date using operators like `$gte` and `$lte`.

**updated\_at** `object`

Filter by update date using operators like `$gte` and `$lte`.

## Response

**orders** `object[]`

**properties**

**id** `string`

The order's ID.

**display\_id** `number`

Human-readable order number.

**status** `string`

The order's status.

**currency\_code** `string`

The order's currency.

**total** `number`

The order's total amount.

**customer\_id** `string`

ID of the customer who placed the order.

**created\_at** `string`

Creation timestamp.

**updated\_at** `string`

Last update timestamp.

**count** `number`

Total number of matching orders.

**offset** `number`

Number of records skipped.

**limit** `number`

Maximum number of records returned.

```bash cURL theme={null}
curl 'http://localhost:9000/admin/orders?seller_id=sel_01HXYZ&limit=20' \
  -H 'Authorization: Bearer <token>'
```

```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
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.