Skip to content

List invoices

List the selected account's invoices, newest first, with links to Stripe.

Parameters

#
organizationstring
Organization name or ID. A credential, named resource or sole membership can select the organization for you.

Returns

#
dataobjectAlways present
The account's invoices.
Show 1 attributeHide attributes
invoicesobject[] | nullAlways present
Invoice metadata and payment-page links.
Show 1 attributeHide attributes
itemsobject
One invoice and its current payment state.
Show 8 attributesHide attributes
created_atstring (date-time)Always present
When the invoice was created.
due_atstring (date-time)
Payment deadline. May be omitted.
idstringAlways present
Invoice ID.
kindstringAlways present
Invoice category.
numberstring
Invoice number, when assigned. May be omitted.
statusstringAlways present
Payment provider's invoice state.
total_centsintegerAlways present
Invoice total in cents.
urlstring
Hosted invoice page, when available. May be omitted.

Errors

#
CodeStatusWhat happened
invalid400An input is missing or invalid.
unauthenticated401The credential is missing, invalid, expired or revoked.
denied403The caller lacks permission for this action.
not_found404The resource is absent or inaccessible to this caller.
conflict409The request conflicts with the current resource state or an earlier request.
over_capacity409The request exceeds a resource or credential allowance.
access_list_full409The change would exceed the access-list allowance.
rate_limited429The caller's request rate exceeds its limit.
busy429Too much work is in progress to accept this request.
unknown503The outcome is unconfirmed; a change may have happened.
unavailable503The service or requested feature is unavailable.

Notes

#
  • API key permission: billing invoices.