latestOpenAPI 3.1.02026-08-19270462702.4 KB

b92f75fd3b61

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).

router_only_free_creditsboolean

Retired (ENG-5673). Always false — with no router left to fund, included plan credits fund every model. Kept so existing clients keep parsing the snapshot; do not branch on it.

direct_model_inference_availableboolean

Retired (ENG-5673). Always true — the router-only restriction that could clear it no longer exists. Kept so existing clients keep parsing the snapshot; do not branch on it.

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.