v2

latestOpenAPI 3.1.02026-08-05267431678.1 KB

billing

Get Team Full Billing Status

Get full billing status for a team (for billing/admin/owner roles).

This endpoint returns comprehensive billing information including payment methods, usage, and credit limits.

Requires: MANAGE_BILLING permission (owner, admin, or billing role)

Args: team_id: Team UUID auth: Authenticated user context

Returns: Full team billing status including payment methods and usage

get/billing/team/{team_id}/full-status

team_idstring required

Successful Response

team_idstring required

team_namestring required

payment_planstring required

has_payment_methodboolean required

billing_namestring nullable

Customer-level billing name on file in Stripe (display-only).

total_usagenumber required

credit_limitnumber required

free_tier_remainingnumber required

exceeds_free_tierboolean required

cancel_at_period_endboolean

True when the subscription is scheduled to cancel at the end of the current billing period.

current_period_endstring nullable

ISO timestamp when the current billing period ends. Present when cancel_at_period_end is true.