Path Parameters
Response Fields
One of
incomplete, incomplete_expired, active, past_due, unpaid, canceled. See Statuses.When the first charge was paid — the anchor of the billing cycle.
null while incomplete.When the next renewal (or retry) is debited.
null while a charge is in flight, and on terminal or unpaid subscriptions.Total number of payments for an installment plan;
null for an open-ended subscription.Why: for example
completed (max_cycles reached), dunning_exhausted, customer_wallet_closed or at_period_end.The most recent charge, in the shape described on List Charges.
A
subscription_id that does not belong to your merchant returns 404 subscription_not_found — never a 403 — so an identifier leaks nothing about other merchants.