Preview plan change

Changed on

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Shows what upgrading your workspace to another plan costs, without changing or charging anything. Pass the price ID of the plan you're considering, from price_ids in List plans. Only the workspace owner can preview.

The preview mirrors Change plan: prorated_amount_due is what that call charges now, and recurring_amount is what the new plan costs at each renewal. It previews upgrades only. A downgrade returns 400, because a downgrade charges nothing now and takes effect at the end of the billing period.

This previews plans billed through Stripe. For a workspace billed through Wix, use Preview Wix plan change. A Wix-billed workspace can still get a result here, but it doesn't apply to its plan.

The base rate limit is 20 requests per minute per user. See Rate limits for the multiplier your plan gets.

<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.</Warning>

post/api/billing/preview-upgrade/{price_id}

Request

  • Base URL
    https://app.base44.com
  • URL
    https://app.base44.com/api/billing/preview-upgrade/{price_id}
  • Auth
    HTTP bearer

Path parameters

price_idstring required

Price ID of the plan to preview, from price_ids in List plans.

Response

What the upgrade costs now and at renewal.

prorated_amount_duenumber required

Amount Change plan charges now for this upgrade, in major units of currency (dollars, not cents). When full_diff is true, this is the full price difference rather than a prorated amount.

currencystring required

Lowercase three-letter currency code of both amounts.

next_billing_dateinteger required

When the new plan next renews, as a Unix timestamp in seconds.

recurring_amountnumber required

What the new plan costs at each renewal, in major units of currency.

billing_intervalstring required

How often the new plan renews: month or year.

full_diffboolean required

true when prorated_amount_due is the full price difference between the plans, not a prorated share of it.

Example response

{
  "prorated_amount_due": 12.5,
  "currency": "usd",
  "next_billing_date": 1767225600,
  "recurring_amount": 50,
  "billing_interval": "month"
}

Changes