ChargebeeAPI

List invoices

Try in API Explorer

Lists all the Invoices.

Sample Request

URL Format

GET https://[site].chargebee.com/api/v2/invoices

Input Parameters

include_deleted
optional, boolean, default=false

If set to true, includes the deleted resources in the response. For the deleted resources in the response, the 'deleted ' attribute will be 'true '.

einvoice
optional, object

Parameters for einvoice

Filter Params

For operator usages, see the Pagination and Filtering section.
id[<operator>]

optional, string filter

The invoice number. Acts as a identifier for invoice and typically generated sequentially. Supported operators : is, is_not, starts_with, in, not_in

Example → id[is] = "INVOICE_654"

Supported operators: is, is_not, starts_with, in, not_in
subscription_id[<operator>]

optional, string filter

To filter based on subscription_id. NOTE: Not to be used if consolidated invoicing is enabled. Supported operators : is, is_not, starts_with, is_present, in, not_in

Example → subscription_id[is] = "3bdjnDnsdQn"

Supported operators: is, is_not, starts_with, is_present, in, not_in
customer_id[<operator>]

optional, string filter

The identifier of the customer this invoice belongs to. Supported operators : is, is_not, starts_with, in, not_in

Example → customer_id[is] = "3bdjnDnsdQn"

Supported operators: is, is_not, starts_with, in, not_in
recurring[<operator>]

optional, boolean filter

Boolean indicating whether this invoice belongs to a subscription. Possible values are : true, false

Supported operators : is

Example → recurring[is] = "true"

Supported operators: is
status[<operator>]

optional, enumerated string filter

Current status of this invoice. Possible values are : paid, posted, payment_due, not_paid, voided, pending.

Supported operators : is, is_not, in, not_in

Example → status[is] = "paid"

Supported operators: is, is_not, in, not_in
price_type[<operator>]

optional, enumerated string filter

The price type of the invoice. Possible values are : tax_exclusive, tax_inclusive.

Supported operators : is, is_not, in, not_in

Example → price_type[is] = "tax_exclusive"

Supported operators: is, is_not, in, not_in
date[<operator>]

optional, timestamp(UTC) in seconds filter

The document date displayed on the invoice PDF. Supported operators : after, before, on, between

Example → date[on] = "1394532759"

Supported operators: after, before, on, between
paid_at[<operator>]

optional, timestamp(UTC) in seconds filter

Timestamp indicating the date & time this invoice got paid. Supported operators : after, before, on, between

Example → paid_at[before] = "1394532759"

Supported operators: after, before, on, between
total[<operator>]

optional, in cents filter

Invoiced amount displayed in cents; that is, a decimal point is not present between the whole number and the decimal part. For example, $499.99 is displayed as 49999, and so on. Supported operators : is, is_not, lt, lte, gt, gte, between

Example → total[gt] = "1000"

Supported operators: is, is_not, lt, lte, gt, gte, between
amount_paid[<operator>]

optional, in cents filter

Payments collected successfully for the invoice. This is the sum of linked_payments[].txn_amount for all linked_payments[] that have txn_status as success. Supported operators : is, is_not, lt, lte, gt, gte, between

Example → amount_paid[lt] = "800"

Supported operators: is, is_not, lt, lte, gt, gte, between
amount_adjusted[<operator>]

optional, in cents filter

Total adjustments made against this invoice. Supported operators : is, is_not, lt, lte, gt, gte, between

Example → amount_adjusted[gte] = "100"

Supported operators: is, is_not, lt, lte, gt, gte, between
credits_applied[<operator>]

optional, in cents filter

Total credits applied against this invoice. Supported operators : is, is_not, lt, lte, gt, gte, between

Example → credits_applied[lte] = "100"

Supported operators: is, is_not, lt, lte, gt, gte, between
amount_due[<operator>]

optional, in cents filter

The unpaid amount that is due on the invoice. This is calculated as: total

Example → amount_due[lt] = "200"

Supported operators: is, is_not, lt, lte, gt, gte, between
dunning_status[<operator>]

optional, enumerated string filter

Current dunning status of the invoice. Possible values are : in_progress, exhausted, stopped, success.

Supported operators : is, is_not, in, not_in, is_present

Example → dunning_status[is] = "in_progress"

Supported operators: is, is_not, in, not_in, is_present
payment_owner[<operator>]

optional, string filter

Payment owner of an invoice. Supported operators : is, is_not, starts_with, in, not_in

Example → payment_owner[is] = "payment_customer"

Supported operators: is, is_not, starts_with, in, not_in
updated_at[<operator>]

optional, timestamp(UTC) in seconds filter

To filter based on updated_at. This attribute will be present only if the resource has been updated after 2016-09-28. It is advisable when using this filter, to pass the sort_by input parameter as updated_at for a faster response. Supported operators : after, before, on, between

Example → updated_at[after] = "1243545465"

Supported operators: after, before, on, between
channel[<operator>]

optional, enumerated string filter

The subscription channel this object originated from and is maintained in. Possible values are : web, app_store, play_store.

Supported operators : is, is_not, in, not_in

Example → channel[is] = "APP STORE"

Supported operators: is, is_not, in, not_in
voided_at[<operator>]

optional, timestamp(UTC) in seconds filter

Timestamp indicating the date & time this invoice got voided. Supported operators : after, before, on, between

Example → voided_at[on] = "1394532759"

Supported operators: after, before, on, between
void_reason_code[<operator>]

optional, string filter

Reason code for voiding the invoice. Select from a list of reason codes set in the Chargebee app in Settings > Configure Chargebee > Reason Codes > Invoices > Void invoice. Must be passed if set as mandatory in the app. The codes are case-sensitive. Supported operators : is, is_not, starts_with, in, not_in

Example → void_reason_code[is_not] = "Other"

Supported operators: is, is_not, starts_with, in, not_in

Returns

next_offsetoptional, string, max chars=1000

This attribute is returned only if more resources are present. To fetch the next set of resources use this value for the input parameter offset.

invoiceInvoice object

Resource object representing invoice