Unary · Billing
Returns daily enterprise AI usage totals for the organization.
Each day reports BYOK token spend (cost and tokens) with per-user,
per-team, and per-model breakdowns. Per-user entries cover the top
spenders with the remainder aggregated into an “Others” bucket; usage
not attributed to a user or service account appears only in the daily
totals. The credits field is not populated by this endpoint.
When filter.subject is set the response contains only that subject’s
usage: daily totals and the team breakdown are omitted, and the model
breakdown covers the subject only.
Use this method to:
- Chart daily BYOK AI spend over a date range
- Feed daily per-user usage into external dashboards
- Restrict the response to a single user or service account
Examples
-
Get daily usage for January:
Returns one entry per day with per-user, per-team, and per-model
breakdowns. Both dates are inclusive and the range must not exceed
31 days.
Authorization
Requiresbilling:read_usage permission on the organization.
Endpoint
https://app.ona.com with that domain.
Request example
Request
gitpod.v1.GetEnterpriseAIUsageTimeSeriesRequest
Response
gitpod.v1.GetEnterpriseAIUsageTimeSeriesResponse
Related types
DailyEnterpriseAIUsage
DailyEnterpriseAIUsage
gitpod.v1.DailyEnterpriseAIUsageDateRange
DateRange
DateRange specifies a time period for queries.
gitpod.v1.DateRangeEnterpriseAIUsage
EnterpriseAIUsage
gitpod.v1.EnterpriseAIUsageEnterpriseAIUsageBudget
EnterpriseAIUsageBudget
gitpod.v1.EnterpriseAIUsageBudgetEnterpriseAIUsageByModel
EnterpriseAIUsageByModel
gitpod.v1.EnterpriseAIUsageByModelEnterpriseAIUsageTimeSeriesFilter
EnterpriseAIUsageTimeSeriesFilter
gitpod.v1.EnterpriseAIUsageTimeSeriesFilterSubject
Subject
gitpod.v1.SubjectTeamEnterpriseAIUsage
TeamEnterpriseAIUsage
gitpod.v1.TeamEnterpriseAIUsageUserEnterpriseAIUsage
UserEnterpriseAIUsage
gitpod.v1.UserEnterpriseAIUsageBillingCurrency
BillingCurrency
EnterpriseAIUsageBudgetSource
EnterpriseAIUsageBudgetSource
Principal
Principal