List orders
Returns a paginated list of orders for an organization, filterable by status, channel, search term and an advanced filter definition.
Authorizations
JWT access token or API token (prefixed with zipp_)
Path Parameters
Organization ID
"org_8f3kd92ld0"
Query Parameters
Page number (1-based)
1 <= x <= 90071992547409911
Items per page (max 100)
1 <= x <= 10020
Filter by brand. Pass a brand ID, or "none" for records not assigned to any brand.
"brnd_8f3kd92ld0"
How the brand context narrows this list: "own" returns only rows assigned to the current brand (requires a brand session, a brand-bound token, or the X-Zippendo-Brand header), "shared" returns only unassigned organization-wide rows, "both" (default) returns both. The X-Zippendo-Brand-Scope header supplies a default when the parameter is omitted. For strictly brand-owned records (orders, shipments), a brand-scoped request combined with "shared" returns no rows, since those records are never visible organization-wide from within a brand context.
own, shared, both "own"
Order fulfillment status derived from its shipments.
pending, processing, partially_fulfilled, fulfilled, error, cancelled "processing"
Filter by order channel ID.
"clz9k2f0a0001abcd1234efgh"
Search by order number or customer name/email.
"Anna"
Advanced filter as a JSON-encoded definition: a conjunction (and/or) over conditions, each { id, field, operator, value } or a nested group. Fields and operators per list are documented under Filtering lists in the API overview. An invalid filter returns 400 FILTER_INVALID.
8000"{\"conjunction\":\"and\",\"conditions\":[{\"id\":\"c_1\",\"field\":\"status\",\"operator\":\"in\",\"value\":[\"pending\",\"processing\"]}]}"