payment

Validate Plan Change

Validate if a plan change is possible for an organization.

CRITICAL: For downgrades, this strictly validates current usage against target plan limits. Returns detailed errors if the downgrade would exceed limits.

For upgrades, this estimates the proration amount (actual amount calculated by Stripe).

post/api/payment/subscription/validate-plan-change

Request

  • Base URL: https://api.usepomo.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.usepomo.ai/api/payment/subscription/validate-plan-change
  • Auth: HTTP bearer

Request body

payment_method_idstring nullable
organization_idstring required
target_planstring required
billing_intervalstring nullable

Response

Successful Response

is_validboolean required
is_upgradeboolean required
is_downgradeboolean required
current_planstring required
target_planstring required
billing_currencystring nullable
billing_intervalstring nullable
errorsstring[]
current_usageobject
target_limitsobject
proration_amountnumber nullable
blocking_itemsobject nullable
payment_methodobject nullable

Changes

No recorded changes to this operation across all 1 revision of this API.