Billing

Preview a subscription plan change

Previews an authenticated user's immediate upgrade or next-renewal downgrade. Stripe calculates the upgrade proration; downgrades keep the current plan and credits active until the current period ends.

post/billing/me/subscription/preview

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/billing/me/subscription/preview
  • Auth: API key in header x-api-key

Request body

idempotency_keystring
planstring
previewed_atstring
proration_dateinteger

Example request

{
  "idempotency_key": "billing-change-01J8W7Q8",
  "plan": "Growth",
  "previewed_at": "2026-09-12T12:00:00Z",
  "proration_date": 1789473600
}

Response

Subscription change preview

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 3 revisions of this API.