---
title: "Preview a plan change"
method: POST
path: "/billing/plan-change/preview"
tags: ["Billing"]
---

# Preview a plan change

`POST /billing/plan-change/preview`

Preview the cost and effect of changing to a plan without applying it. Requires a user credential with `billing:manage`.

## Request body

- object
  - `organizationId` string — Organization to operate on. Auto-filled from CLI and SDK context when omitted. User tokens must supply it unless the credential's fixed scope resolves it; secret keys may omit it (the key's organization applies).
  - `planSlug` string, required

## Response `200`

OK

- object
  - `calculatedAt` string, date-time, required
  - `type` 'upgrade' | 'downgrade', required
  - `effectiveAt` string, date-time, required
  - `currency` string, required
  - `currentPlanSlug` string, required
  - `targetPlanSlug` string, required
  - `currentPlanName` string, required
  - `targetPlanName` string, required
  - `currentPlanPrice` string, required
  - `targetPlanPrice` string, required
  - `currentCycleCredits` string, required
  - `currentTargetCreditBalance` string, required
  - `cycleCredits` string, required — Credits added to the balance each paid cycle (billing_plans.config.cycleCredits). Additive, never a balance target.
  - `targetCreditBalance` string, required
  - `creditDeficitAmount` string, required
  - `creditDeficitChargeAmount` string, required
  - `additionalCreditPrice` string, required
  - `immediateChargeAmount` string, required
  - `subscriptionChargeAmount` string, required
  - `proratedCreditGrantAmount` string, required
  - `remainingCycleFraction` string, required
  - `nextCycleChargeAmount` string, required

## Changes

- **2026-09-04** `f7ae8f775456` — 2 info
  - added the required property `currentCycleCredits` to the response with the `200` status
  - added the required property `cycleCredits` to the response with the `200` status

[Change history](https://skmtc.dev/sazabi/apis/sazabi-public-api/changes/billing/plan-change/preview/post.md)

---

[API](https://skmtc.dev/sazabi/apis/sazabi-public-api.md) · [All operations](https://skmtc.dev/sazabi/apis/sazabi-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sazabi/sazabi-public-api/revisions/1d12b71c735a/schema)