Sign in
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.

Changes

Changed in 1 of the 3 revisions of this API.1

  • 31dfe831e0791See the full diff
    • ○

      added the optional property current_period_start to the response with the 200 status

      response-optional-property-added