v2

latestOpenAPI 3.1.02026-08-05267431678.1 KB
billing

Get Team Member Usage

Get per-member usage breakdown for a date range.

Requires MANAGE_BILLING — owner, admin, and billing roles all qualify. Usage is scoped to requests billed to this team. Defaults to the team's current billing period (created_at >= teams.current_period_start) when no range is given, matching the page's original default.

Returns per-member usage including:

  • User email and name
  • Total credits used in the range
  • Request count in the range

Args: team_id: Team UUID start_date: Optional ISO range start; defaults to the current billing period start end_date: Optional ISO range end; defaults to now full_history: When true, include every request ever billed to the team auth: Authenticated user context

Returns: Team usage breakdown by member

get/billing/team/{team_id}/usage

Path parameters

team_idstring required

Query parameters

start_datestring nullable

Range start (ISO date or datetime, UTC); ignored when full_history=true

Range start (ISO date or datetime, UTC); ignored when full_history=true

end_datestring nullable

Range end (ISO date or datetime, UTC); defaults to now

Range end (ISO date or datetime, UTC); defaults to now

full_historyboolean

If true, include all requests ever billed to the team; ignores start_date

If true, include all requests ever billed to the team; ignores start_date

Response

Successful Response

team_idstring required
team_namestring required
total_usagenumber required