Billing

Apply a subscription plan change

Applies an immediate, prorated upgrade after Stripe payment succeeds, or schedules a downgrade for the next renewal. The unused legacy metered item is removed as part of an immediate upgrade.

post/billing/me/subscription/change

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/billing/me/subscription/change
  • 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 result

codeinteger
msgstring

Example response

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

Changes

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