Skip to content

Top-up price quote

GET
/api/v1/billing/topup-pricing

Return per-plan credit top-up pricing (USD per 1,000 credits) from the canonical PLAN_DEFINITIONS catalogue and a configured flag indicating whether Stripe checkout is ready. When configured=False the checkout endpoint will fail; the UI must show an ‘unavailable’ message instead of a dead button.

Authorizations

Responses

200

Successful Response

Response for GET /api/v1/billing/topup-pricing.

Attributes: configured: True when all STRIPE_TOPUP_PRICE_* env vars are set to real (non-placeholder) Stripe Price IDs. When False the checkout flow cannot execute and the UI must say so instead of showing a dead checkout button. prices_per_1k: Per-plan top-up price in USD per 1,000 credits, keyed by plan tier value. None when Stripe is not configured. Prices come from the canonical PLAN_DEFINITIONS catalogue.

object
configured
required
boolean
prices_per_1k
required
Any of:
object
key
additional properties
integer