Skip to main content
GET
/
vendor
/
orders
curl 'http://localhost:9000/vendor/orders?limit=20&order=-created_at' \
  -H 'Authorization: Bearer <token>' \
  -H 'x-seller-id: <seller_id>'

{
  "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
}
Returns all non-draft orders belonging to the authenticated seller, with optional filtering by status, customer, region, and more.

​
Query parameters

​
limit
number
default:"50"
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 list of fields to include, prefix with +/- to add or remove from defaults.
​
q
string
Search term matched against order fields.
​
id
string | string[]
Filter by order ID(s).
​
status
string | string[]
Filter by order status.
​
customer_id
string | string[]
Filter by customer ID(s).
​
sales_channel_id
string | string[]
Filter by sales channel ID(s).
​
region_id
string | string[]
Filter by region ID(s).
​
currency_code
string | string[]
Filter by currency code(s).
​
fulfillment_status
string
Filter by fulfillment status.
​
payment_status
string
Filter by payment status.
​
created_at
object
Filter by creation date with operators like $gte, $lte.
​
updated_at
object
Filter by update date with operators like $gte, $lte.

​
Response

​
orders
object[]
​
count
number
Total number of matching orders.
​
offset
number
Number of records skipped.
​
limit
number
Number of records returned.
curl 'http://localhost:9000/vendor/orders?limit=20&order=-created_at' \
  -H 'Authorization: Bearer <token>' \
  -H 'x-seller-id: <seller_id>'

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