Get bill details

GET 
/bills/:billNumber

Returns the full record for a single bill including the vendor, dates, payment terms, all line items with pricing, and financial totals. Use this to reconcile vendor payments or feed AP data into an external system.

Request

Response

200

Full bill details

401

Unauthorized — missing or invalid API key

404

Resource not found

Response

{
  "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
    }
  ]
}