---
title: "Preview Subscription Upgrade"
method: GET
path: "/v1/subscription/upgrade-preview"
tags: ["Subscription"]
---

# Preview Subscription Upgrade

`GET /v1/subscription/upgrade-preview`

## Request

- Base URL: `https://api.flower.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.flower.ai/v1/subscription/upgrade-preview`
- Auth: HTTP bearer

Preview a higher-tier subscription price without changing Stripe.

## Query parameters

- `flwr_aid` string, required
- `product_id` integer, required: The target Product ID

## Response `200`

Successful Response

- SubscriptionUpgradePreviewResponse: Customer-visible Stripe preview for one subscription upgrade.
  - `amount_due` integer, required
  - `total` integer, required
  - `currency` string, required
  - `new_recurring_amount` integer, required
  - `billing_interval` string, required
  - `current_product_id` integer, required
  - `new_product_id` integer, required
  - `current_credits` integer, required
  - `new_credits` integer, required
  - `effective_at` integer, required
  - `current_period_end` integer, required
  - `cancel_at_period_end` boolean, required
  - `cancel_at` integer, nullable, required
  - `confirmation` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-24** `f33d179b8fb4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/flower/apis/superlink-api/changes/v1/subscription/upgrade-preview/get.md)

---

[API](https://skmtc.dev/flower/apis/superlink-api.md) - [All operations](https://skmtc.dev/flower/apis/superlink-api/llms.txt) - [OpenAPI document](https://skmtc.dev/flower/apis/superlink-api/revisions/1852f36490d7?raw)