List Purchase Orders
Returns a paginated list of purchase orders for the authenticated business. Supports filtering by status, supplier, location, and creation date range.
Requires scope: purchase_orders:read
Authentication
Query parameters
Zero-based page index. Defaults to 0.
Items per page. Defaults to 20, maximum 100.
Return only orders created on or after this date (ISO 8601, e.g. 2026-01-01).
Return only orders created on or before this date (ISO 8601, e.g. 2026-03-31).
Sort by field,direction (Spring Pageable format; direction asc or desc, default asc). Allowed fields: id, orderNumber, status, type, totalCost, note, dueDate, receivedAt, createdAt, updatedAt. subtotal is not sortable: it is computed from the line items rather than stored. Default order (when no sort is supplied): createdAt,desc.