List sales orders

GET 
/sales-orders

Returns a paginated list of sales orders across all customers. Each SO includes line items, financial totals, delivery dates, and current status. Filter by status, customer, or date range. SO statuses progress from draft through confirmed and scheduled to completed, with cancelled as a terminal state.

Request

Response

200

Paginated sales orders

400

Bad request — invalid parameters

401

Unauthorized — missing or invalid API key

Response

{
  "data": [
    {
      "orderNumber": "SO-2025-0189",
      "customerId": null,
      "customerName": "Sunrise Craft Beverages",
      "orderDate": "2025-02-18",
      "expectedDeliveryDate": "2025-03-15",
      "status": "confirmed",
      "subtotal": 6250,
      "discountAmount": 0,
      "taxAmount": 500,
      "shippingCharges": 275,
      "totalAmount": 7025,
      "paymentTerms": "Net 30",
      "referenceNumber": null,
      "notes": null,
      "lineItems": [
        {
          "skuId": "1042",
          "skuName": "Roasted Garlic Hummus",
          "quantity": 500,
          "unit": "lbs",
          "unitPrice": 12.5,
          "subtotal": 6250
        }
      ]
    }
  ],
  "pagination": {
    "offset": 0,
    "limit": 20,
    "total": 87
  }
}