List Orders

GET

admin

orders

curl 'http://localhost:9000/admin/orders?seller_id=sel_01HXYZ&limit=20' \
  -H 'Authorization: Bearer <token>'

const { orders, count } = await client.admin.orders.query({
  seller_id: "sel_01HXYZ",
  limit: 20,
})

{
  "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
}

Returns orders platform-wide. Mercur extends the standard Medusa endpoint with seller_id and name filters.

Query parameters

number

default:"15"

Maximum number of records to return.

number

default:"0"

Number of records to skip.

string

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

string

Comma-separated fields to include in the response.

string

Search term matched against orders.

string | string[]

Filter by order ID(s).

string | string[]

Filter by order status.

string | string[]

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

string | string[]

Filter by order name(s).

string[]

Filter by sales channel IDs.

string | string[]

Filter by region ID(s).

string | string[]

Filter by customer ID(s).

object

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

object

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

object

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

Response

object[]

Show properties

string

The order’s ID.

number

Human-readable order number.

string

The order’s status.

string

The order’s currency.

number

The order’s total amount.

string

ID of the customer who placed the order.

string

Creation timestamp.

string

Last update timestamp.

number

Total number of matching orders.

number

Number of records skipped.

number

Maximum number of records returned.

curl 'http://localhost:9000/admin/orders?seller_id=sel_01HXYZ&limit=20' \
  -H 'Authorization: Bearer <token>'

const { orders, count } = await client.admin.orders.query({
  seller_id: "sel_01HXYZ",
  limit: 20,
})

{
  "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
}

curl 'http://localhost:9000/admin/orders?seller_id=sel_01HXYZ&limit=20' \
  -H 'Authorization: Bearer <token>'

const { orders, count } = await client.admin.orders.query({
  seller_id: "sel_01HXYZ",
  limit: 20,
})

{
  "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
}

Overview

Panel extensions

Admin API

Vendor API

Store API

Configuration

Query parameters

Response

​Query parameters

​Response

Query parameters

Response