currency’s minor unit (for example, cents for USD). Timestamps such as created, dueDate, and period boundaries are Unix epoch seconds. Both endpoints are cursor-paginated: pass the id of the last item you saw as starting_after to fetch the next page while hasMore is true.
Key concepts
| Concept | Description |
|---|---|
| Invoice | A finalized consolidated bill — status, currency, amountDue/amountPaid/amountRemaining, total, and hosted/PDF links |
| Pending invoice item | An accrued line item that will appear on the next consolidated invoice |
| Amounts | Integer minor units of currency (e.g. cents) |
| Timestamps | Unix epoch seconds |
| Pagination | Cursor-based via starting_after + hasMore + cursor |
Task reference
List invoices
GET /billing/invoices — issued consolidated invoicesList pending invoice items
GET /billing/pending-invoice-items — accrued, not yet billed