v2

latestOpenAPI 3.1.02026-08-05267431678.1 KB

billing

Get Billing Status

Get billing status for the authenticated user.

Returns: - Total token usage - Free tier remaining tokens - Whether user has exceeded free tier - Whether user has a payment method on file - Stripe customer ID - List of payment methods

get/billing/billing-status

Response

Successful Response

team_idstring nullable

total_usagenumber required

free_tier_remainingnumber required

exceeds_free_tierboolean required

has_payment_methodboolean required

card_verifiedboolean

stripe_customer_idstring nullable

payment_planstring

billing_activatedboolean

Authoritative inference-gate result computed from the same billing fields the request path reads. Frontend surfaces (paywall, upgrade CTA) MUST consume this field instead of re-deriving from payment_plan / card_verified.

credit_limitnumber required

paid_credit_balancenumber

Persistent paid credit wallet balance (credits). Funds direct individual-model inference; included allowance funds the router.

router_only_free_creditsboolean

Whether included plan credits are restricted to router inference for this team (direct models require paid credits).

direct_model_inference_availableboolean

Whether the team can currently run direct (non-router) individual models. False when the router-only restriction is active and the team has no spendable paid credit balance (overage headroom alone does not qualify — a direct-model row only debits the paid wallet).

current_period_startstring nullable

ISO timestamp when the team's current billing period started (mirrors teams.current_period_start). None when the user has no active team.