Skip to main content
GET
The nested variant of List orders: the store is identified by the {storeId} path parameter instead of a query filter. All other query parameters — pagination, filters and field projection — behave the same. The tenant guard guarantees that a storeId belonging to another account/vendor returns an empty list — never another tenant’s orders.

Authentication

string
required
Your Fire API key with the orders:read scope. The key must be vendor-scoped — keys without a vendorId are rejected with 403.

Path parameters

string
required
Store UUID (stores.id).

Query parameters

The account and vendor are derived from your API key (vendor-scoped) — you do not send them as query params.
string
Projection — see Field projection.
string
OPEN, COMPLETED, FORCE_CLOSED, CANCELLED.
string
PENDING, SUCCEEDED, FAILED.
string
Exact business day, YYYY-MM-DD.
string
Range start, YYYY-MM-DD.
string
Range end, YYYY-MM-DD.
string
default:"business_day"
business_day or created_at.
string
default:"+00:00"
Timezone offset for created_at mode.
string
Channel code.
string
Fulfillment service code.
string
Payment method code.
string
Partial match on order code.
Exact UUID, or partial external order id / order code.
integer
default:"1"
Page number (1-based).
integer
default:"20"
Page size (1–100).

Request

Response

Same shape as List orders: { orders, pagination }. To see how each order’s collection is going, project settlement — see Payment progress.

List orders

List all orders of your account and vendor.

Get store

Read the store this listing belongs to.