Using AI coding agents like Claude Code or Cursor? Try the official Chargebee Agent Skills to speed up your development.Try now
ChargebeeAPI

Upcoming invoices estimate

Estimate of the upcoming scheduled invoices (subscription activations, renewals etc) of a customer. For now preview of the invoices generated on the immediate upcoming date is supported. Say a customer has couple of subscription renewals scheduled on Jan,10th and another subscription renewal scheduled on Jan,15th. This API gives the preview of all the invoices scheduled to be generated on Jan,10th (immediate upcoming date).

In the response:

  • estimate.invoice_estimates[] has details of the invoices scheduled to be generated.

Note: If consolidated invoicing is enabled you may use this API to test whether upcoming renewals are consolidated.

Sample Request

Sample Result[JSON]

URL Format

GET https://[site].chargebee.com/api/v2/customers/{customer-id}/upcoming_invoices_estimate

Input Parameters

include_usage_charges
optional, boolean, default=false

When set to true, the invoice_estimates[] returned in the response includes usage-based line items, if any. These are invoice_estimates[].line_items[] where line_items[].metered is true.

Returns

Estimate object
Resource object representing estimate