Preview a Subscription Plan Change
Show what POST /v1/billing/plan-changes would do for the same plan without changing anything: the amount charged on confirmation, when the plan takes effect, the recurring price after it, and the card on file. Refuses exactly what the plan change refuses.
Authentication
Your aVenture API key (https://aventure.vc/settings/api-keys) or OAuth access token
Request
AI Plus or AI Pro plan to move to; the current plan cancels a scheduled change
Unix epoch-second timestamp from an upgrade preview that pins its prorated amount on confirmation; omit it when no upgrade preview applies
Response headers
Requests allowed per client IP in the current rate-limit window.
Requests left before the tightest applicable rate-limit bucket rejects.
Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.
Response
Amount charged on confirmation in the currency’s minor unit, after credit for unused time; 0 when the change waits for the period end
When the plan would take effect: now, or the current period end
Card Stripe charges; absent when no card is on file
Unix epoch-second timestamp to send on upgrade confirmation so Stripe charges this previewed proration; absent when the change does not prorate now