GET/v1/billing/invoices

List invoices and credit notes

Newest first; top-up invoices are paid at issue, monthly invoices carry the period and the due date.

Scope billing.read

Returns

23 fields of the 200 answer

idstringrequired

numberstringrequired

kindenumrequired

INVOICECREDIT_NOTE

sourceenumrequired

TOP_UPMONTHLYCREDIT

statusenumrequired

ISSUEDPAIDVOID

issueDatedaterequired

dueDatedaterequired

periodFromdate or nullrequired

periodTodate or nullrequired

currencystringrequired

vatTreatmentenumrequired

NL_STANDARDEU_REVERSE_CHARGENON_EU

vatRateintegerrequired

subtotalCentsintegerrequired

vatCentsintegerrequired

totalCentsintegerrequired

paidCentsintegerrequired

paidAtdate-time or nullrequired

sentAtdate-time or nullrequired

creditNoteOfInvoiceIdstring or nullrequired

reasonstring or nullrequired

paymentIdstring or nullrequired

hasPdfbooleanrequired

createdAtdate-timerequired

Responses

200Success

401Authentication required or API key invalid

403Permission or scope missing, organisation suspended

429Rate limited for this API key and class; wait Retry-After seconds

otherError (RFC 9457 problem details)

[ { "id": "inv_01J9Y2K8QF4T6W8Z0B2D4F6H8K", "number": "Example", "kind": "INVOICE", "source": "TOP_UP", "status": "ISSUED", "issueDate": "2026-11-02", "dueDate": "2026-11-02", "periodFrom": "2026-11-02", "periodTo": "2026-11-02", "currency": "EUR", "vatTreatment": "NL_STANDARD", "vatRate": 1, "subtotalCents": 1250, "vatCents": 1250, "totalCents": 1250, "paidCents": 1250, "paidAt": "2026-10-16T09:14:02.000Z", "sentAt": "2026-10-16T09:14:02.000Z", "creditNoteOfInvoiceId": "inv_01J9Y2K8QF4T6W8Z0B2D4F6H8K", "reason": "Example", "paymentId": "pay_01J9Y2K8QF4T6W8Z0B2D4F6H8K", "hasPdf": false, "createdAt": "2026-10-16T09:14:02.000Z" } ]