List Orders
List orders for the authenticated organization using the same filters, sorting, and pagination semantics as the workspace Orders listing page. Requires orders:read.
Authorizations
Bearer API key for server-to-server access. Session auth is also supported in first-party UI flows.
Query Parameters
Optional organization scope for session-authenticated calls. OAuth client credentials resolve the organization from the token.
120Search order number, external order ID, buyer fields, and line-item product/SKU fields.
140Filter by normalized order status group.
to_ship, shipped, completed, pending, return, canceled Comma-separated marketplace platforms (for example shopee,lazada,tiktok,zalora).
200Comma-separated normalized country codes.
200Comma-separated marketplace account IDs.
400Comma-separated sort tokens. Supports multi-sort up to six tokens. Aliases: latest -> updated_desc, oldest -> updated_asc.
240Inclusive lower bound on order created date (YYYY-MM-DD).
Inclusive upper bound on order created date (YYYY-MM-DD).
Result limit per page. Values above 50 are clamped silently. Defaults to 20.
1 <= x <= 50Zero-based pagination offset. Use pagination.nextOffset from the previous response to page forward.
x >= 0