v1
latestOpenAPI 3.1.02026-08-042453938.9 KBInvoices
Preview the upcoming invoice for a subscription
Computes what the customer's next invoice will look like, including any usage charges accumulated so far in the current billing period. Read-only — no charges, invoices, or line items are persisted.
Tax is computed using the same pipeline as the real invoice generator, so STRIPE_TAX merchants get accurate previews (at the cost of a tiny Stripe Tax usage call).
Returns 409 NOT_BILLABLE when the subscription is paused, cancelled, or already past its period end.
get/v1/subscriptions/{id}/upcoming-invoice
Path parameters
idstring required
Response
Default Response