Sign in
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 current UTC month when no range is given.

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 UTC month 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

Changes