Skip to main content
The buyer billing API exposes the consolidated invoices Interchange issues to your customer account, plus the pending invoice items that have accrued but not yet been billed. Together they let you reconcile spend: pending items show what is building toward the next invoice, while issued invoices show what has already been finalized, with status, amounts, and links to the hosted invoice and PDF. All monetary amounts are integers in the invoice 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

ConceptDescription
InvoiceA finalized consolidated bill — status, currency, amountDue/amountPaid/amountRemaining, total, and hosted/PDF links
Pending invoice itemAn accrued line item that will appear on the next consolidated invoice
AmountsInteger minor units of currency (e.g. cents)
TimestampsUnix epoch seconds
PaginationCursor-based via starting_after + hasMore + cursor

Task reference

List invoices

GET /billing/invoices — issued consolidated invoices

List pending invoice items

GET /billing/pending-invoice-items — accrued, not yet billed