Skip to main content
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
Only available for enterprise organizations.

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

Requires billing:read_usage permission on the organization.

Endpoint

Send a Bearer token as described in Authentication. If your organization uses a custom management-plane domain, replace https://app.ona.com with that domain.

Request example

Request

gitpod.v1.GetEnterpriseAIUsageTimeSeriesRequest

Response

gitpod.v1.GetEnterpriseAIUsageTimeSeriesResponse
gitpod.v1.DailyEnterpriseAIUsage
DateRange specifies a time period for queries.gitpod.v1.DateRange
gitpod.v1.EnterpriseAIUsage
gitpod.v1.EnterpriseAIUsageBudget
gitpod.v1.EnterpriseAIUsageByModel
gitpod.v1.EnterpriseAIUsageTimeSeriesFilter
gitpod.v1.Subject
gitpod.v1.TeamEnterpriseAIUsage
gitpod.v1.UserEnterpriseAIUsage