Preview a coupon
Check a promo code before subscribing: validity and the exact totals it produces for a plan/period.
Query parameters
| Field | Type | Description |
|---|---|---|
planoptional | builder | scale | enterprise | Plan to price against (default builder). |
monthsoptional | 1 | 3 | 6 | 12 | Prepay length to price (default 1). |
Response fields
| Field | Type | Description |
|---|---|---|
valid | boolean | Whether the code can be redeemed right now (false → reason). |
kind / value | string / number | percent (1-100) or fixed (USDC off per cycle). |
durationCycles | number | null | How many cycles stay discounted (null = every cycle). |
discountedCycleUsdc | number | One cycle's price with the coupon applied. |
totalUsdc | number | Exact total for the requested months (discounted + full cycles mixed). |
409 with { valid: false, reason } when the code is expired/exhausted/not eligible for the plan. A code you already redeemed stays usable for you even when globally exhausted.