List bills

GET 
/bills

Returns a paginated list of bills (vendor invoices for goods received). Filter by status, vendor, purchase order number, or date range. Bill statuses progress from draft through sent and accepted to fully_paid, with rejected and archived as terminal states.

Request

Response

200

Paginated bills

400

Bad request — invalid parameters

401

Unauthorized — missing or invalid API key

Response

{
  "data": [
    {
      "billNumber": "BILL-2025-0031",
      "vendorInvoiceNumber": "VND-INV-88421",
      "purchaseOrderNumber": "PO-2025-0471",
      "vendorName": "Pacific Ingredients Co.",
      "status": "accepted",
      "invoiceDate": "2025-03-10",
      "dueDate": "2025-04-09",
      "paymentTerms": "Net 30",
      "currency": "USD",
      "subtotal": 2800,
      "taxTotal": 224,
      "totalAmount": 3024,
      "paidAmount": 0,
      "paymentMethod": "bank_transfer",
      "notes": null,
      "lineItems": [
        {
          "lineType": "item",
          "skuCode": "2087",
          "description": "Organic Tahini",
          "quantity": 200,
          "unitOfMeasure": "lbs",
          "unitPrice": 3.25,
          "taxRate": 0.08,
          "taxAmount": 52,
          "lineAmount": 650
        }
      ]
    }
  ],
  "pagination": {
    "offset": 0,
    "limit": 20,
    "total": 87
  }
}