Skip to content

Top-up price quote

GET
/api/v1/billing/topup-pricing
curl --request GET \
--url https://api.ultimateteam.ai/api/v1/billing/topup-pricing \
--header 'X-API-Key: <X-API-Key>'

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.

Successful Response

Media typeapplication/json
TopupPricingResponse

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
Configured
boolean
prices_per_1k
required
Any of:
object
key
additional properties
integer
Examplegenerated
{
"configured": true,
"prices_per_1k": {
"additionalProperty": 1
}
}