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

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

​
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[]
​
count
number
Total number of matching orders.
​
offset
number
Number of records skipped.
​
limit
number
Maximum number of records returned.
curl 'http://localhost:9000/admin/orders?seller_id=sel_01HXYZ&limit=20' \
  -H 'Authorization: Bearer <token>'

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