KintsugiKintsugi

List the organization's invoices

GET/billing/invoices

Returns up to the last 12 months of Chargebee invoices for the org selected by Organization-Id, Connection-Id, or Entity-Id, newest first. Empty when the organization has no Chargebee subscription.

Authorization

Api-KeystringRequired

Your secret API key. Include it with every request.

Headers

Api-Versiondate

Release date, as YYYY-MM-DD. Defaults to 2026-07-21.

Organization-Idstring

Target organization id (Organization-Id selector).

Connection-Idstring

Target connection id; resolves to its organization.

Entity-Idstring

Platform entity id; resolves to a connection's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Response

idstringRequired

Chargebee invoice id.

statusstringRequired

Invoice status as reported by Chargebee.

currencyCurrencyEnum

ISO-4217 currency for all amounts.

Available options:AEDAFNALLAMDANGAOAARSAUDAWGAZNBAMBBDBDTBGNBHDBIFBMDBNDBOBBRLBSDBTNBWPBYNBZDCADCDFCHFCLPCNYCOPCRCCUCCUPCVECZKDJFDKKDOPDZDEGPERNETBEURFJDFKPGBPGELGGPGHSGIPGMDGNFGTQGYDHKDHNLHRKHTGHUFIDRILSIMPINRIQDIRRISKJEPJMDJODJPYKESKGSKHRKMFKPWKRWKWDKYDKZTLAKLBPLKRLRDLSLLYDMADMDLMGAMKDMMKMNTMOPMRUMURMVRMWKMXNMYRMZNNADNGNNIONOKNPRNZDOMRPABPENPGKPHPPKRPLNPYGQARRONRSDRUBRWFSARSBDSCRSDGSEKSGDSHPSLLSOSSPLSRDSTNSVCSYPSZLTHBTJSTMTTNDTOPTRYTTDTVDTWDTZSUAHUGXUSDUYUUZSVEFVNDVUVWSTXAFXCDXDRXOFXPFYERZARZMWZWD
recurringbooleanRequired

Whether this invoice is a recurring charge.

datestring

When the invoice was issued.

dueDatestring

When payment is due.

paidAtstring

When the invoice was paid, or null if unpaid.

subTotalstring

Charges before tax.

taxstring

Total tax charged.

totalstring

Total invoice amount.

amountPaidstring

Amount paid so far.

amountDuestring

Amount still owed.

lineItemsInvoiceLineItem[]Required

Charges on this invoice.

issuedCreditNotesCreditNote[]Required

Credit notes issued against this invoice.

200

Successful Response

400

The request was invalid.

401

Authentication failed or was missing.

404

The requested resource was not found.

422

Validation Error

cURL
GET /billing/invoices
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Response
[
{
"id": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"status": "ACTIVE",
"currency": "AED",
"recurring": false,
"date": "2026-07-28T12:00:00Z",
"dueDate": "2026-07-28T12:00:00Z",
"paidAt": "2026-07-28T12:00:00Z",
"subTotal": "10.00",
"tax": "10.00",
"total": "10.00",
"amountPaid": "10.00",
"amountDue": "10.00",
"lineItems": [
{
"entityId": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"description": "Annual software subscription",
"amount": "10.00"
}
],
"issuedCreditNotes": [
{
"id": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"total": "10.00",
"status": "ACTIVE"
}
]
}
]
List the organization's invoices (2026-07-21) | Kintsugi API Reference