Skip to main content

Get customer sales orders

GET 
/customers/:customerId/sales-orders

Returns the sales order history for a specific customer. Each SO includes line items, financial totals, delivery dates, and current status. Filter by date range to focus on a specific period. Use this to review a customer's order volume, track fulfillment progress, or reconcile billing.

Request​

Response​

Paginated sales orders

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
  }
}