/bff/order/list

Page number (1-based) for pagination.

Maximum items per page (1–500, default 50).

Filter by customer external ID.

Filter by order group code.

Filter by order status code.

Full-text search across order number, customer email, first/last name, company name, and phone. Multi-word query: whitespace-separated tokens are AND-ed; each token matches any column (ILIKE, accent-insensitive).

Filter orders whose chosen date column is on or after this date (inclusive). See dateField for which column is targeted (default: inserted_date).

Filter orders whose chosen date column is on or before this date (inclusive). See dateField for which column is targeted (default: inserted_date).

Which date column dateFrom/dateTo apply to: "inserted" (default, created_at), "paid" (paid_at), "updated" (last update), "due" (due_date).

Filter by payment status. "true" = paid only, "false" = unpaid only.

"true" = orders past their due_date and still unpaid (cashflow follow-up); "false" = orders that are either still in time or already paid.

Lower bound for the order total price (inclusive). Compared in raw order currency.

Upper bound for the order total price (inclusive). Compared in raw order currency.

Broad status type code – aggregates all org-specific statuses sharing the same type. "new" / "processing" / "done" / "storno".

"true" = order has at least one invoice; "false" = no invoice has been issued yet.

Aggregated outcome of online payment attempts: "paid" (succeeded), "failed" (cancelled/timeouted, never paid), "pending" (in flight), "none" (no online payment attempt at all).

"true" = exclude orders whose customer is flagged as a test account.

"true" = orders with a non-empty public notice (customer wrote a message). "false" = orders without a public notice. Internal notices are not considered.

Comma-separated list of key:value tag pairs (matches the code field on the grid-configuration tag list). Inclusive OR — an order matches if it carries AT LEAST ONE of the listed pairs. Unknown or malformed pairs are silently ignored.