/api/v1/plans/List all active subscription plans with pricing, features, and Stripe price IDs.
List all active subscription plans with pricing, features, and Stripe price IDs. PUBLIC — NO authentication required. EXEMPT (`cost: 0`).
Why use this
Common use case
Public subscription-plan catalogue. PUBLIC — NO authentication required. EXEMPT (cost: 0). Filtered to is_active=true and sorted by price ASC. Each plan carries the Stripe Price object ID (stripe_price_id) needed by POST /api/v1/payment/create-checkout-session to initiate the Stripe-hosted upgrade flow. PRICES ARE IN CENTS — divide by 100 for USD display (e.g. price: 2900 = $29.00/month). The features array is rendered as bullet points on the pricing cards. To check a user's current plan use GET /api/v1/billing/subscription. For the canonical Phase 56+ token-balance surface (the live counter shown on the customer dashboard) use GET /api/v1/account/balance.
Response schema
| Field | Type | Nullable | Description |
|---|---|---|---|
| status | string | no | ApiResponse envelope status — `success` on 200. |
| request_id | string | yes | Per-request correlation ID. |
| timestamp | string | no | ISO-8601 UTC timestamp. |
| data | array | no | Array of active plans, sorted by `price ASC` (cheapest first). Empty array only if all plans are inactive (operational issue — plans are seeded at deployment). |
| data[].id | integer | no | Plan database ID. Pass to [POST /api/v1/payment/create-checkout-session](/docs/account/billing-and-subscription/post-payment-create-checkout-session) via `?plan_id=N` to initiate the Stripe-hosted upgrade flow. |
| data[].name | string | no | Plan display name (e.g. `Free`, `Paid`, `Pro`). Casing follows brand guidelines — use verbatim in pricing-card UIs rather than lowercasing client-side. |
| data[].stripe_price_id | string | yes | Stripe Price object ID in `price_XXXXX` format. Null for the Free plan (no Stripe price — checkout for Free is rejected at create-checkout-session). Used server-side to construct the Stripe Checkout `line_items[].price`. |
| data[].price | integer | no | Plan price in CENTS (integer). E.g. `2900` = $29.00/month. 0 for the Free plan. Divide by 100 for USD display: `(price / 100).toFixed(2)`. |
| data[].currency | string | no | ISO-4217 currency code. Defaults to `USD` server-side. Use to render currency symbol ($ / € / £). |
| data[].interval | string | no | Billing interval — `month` (default), `week`, `year`. Drives '/month' vs '/year' suffix on pricing cards. |
| data[].features | array | no | JSON array of feature-bullet strings for the pricing-card UI (`features: ["2,000 tokens/month", "Community support", ...]`). Empty array on plans that haven't been content-populated yet (operational gap). |
| data[].is_active | boolean | no | Always true in the response (the query filter is `is_active=True`). Inactive plans are hidden from the public catalog by default. Inactive plans still service existing subscribers — they're just not offered to new signups. |
Sample response
- "status": "success"
- "request_id": "req_3OqK2jK9L8pQ4xZ4"
- "timestamp": "2026-05-02T15:51:00.000Z"
- "data":
Errors
| Status | Label | Description |
|---|---|---|
| 200 | OK | Request succeeded. |
| 400 | Bad Request | Invalid query, body, or path parameter. |
| 401 | Unauthorized | Missing or invalid Authorization header / api_Token. |
| 402 | Payment Required | Insufficient token balance for this call. Top up |
| 429 | Too Many Requests | Rate limit exceeded for your tier (see /pricing for tier limits). Tier limits |
| 500 | Server Error | Unexpected server-side failure. Retry with backoff; report if persistent. |
Code samples
curl "https://api.finradar.ai/api/v1/plans/" \
-H "Authorization: Bearer YOUR_JWT_TOKEN"Generate an API key in /account/credentials to run live queries (literal YOUR_API_KEY placeholder shown until then).