List invoices

GET 
/invoices

Returns a paginated list of invoices. Filter by status, sales order number, customer, or date range. Invoice statuses progress from draft through sent and viewed to paid, with voided and archived as terminal states.

Request

Response

200

Paginated invoices

400

Bad request — invalid parameters

401

Unauthorized — missing or invalid API key

Response

{
  "data": [
    {
      "invoiceNumber": "INV-2025-0073",
      "salesOrderNumber": "SO-2025-0189",
      "customerName": "Sunrise Craft Beverages",
      "status": "sent",
      "invoiceDate": "2025-03-12",
      "dueDate": "2025-04-11",
      "paymentTerms": "Net 30",
      "subtotal": 6250,
      "discountAmount": 0,
      "taxAmount": 500,
      "shippingCharges": 275,
      "totalAmount": 7025,
      "paymentMethod": "bank_transfer",
      "shipmentNumber": "SHP-2025-0042",
      "notes": null,
      "lineItems": [
        {
          "skuId": "1042",
          "skuName": "Roasted Garlic Hummus",
          "description": "Roasted Garlic Hummus - 16oz",
          "quantity": 500,
          "unit": "lbs",
          "unitPrice": 12.5,
          "amount": 6250
        }
      ]
    }
  ],
  "pagination": {
    "offset": 0,
    "limit": 20,
    "total": 87
  }
}