Skip to main content
Unary · Billing Returns cumulative credit usage for an organization and its teams. Use this method to:
  • Get the total cumulative credit consumption as of a point in time
  • Get per-team cumulative usage with credit allocation (budget) comparison
  • Display team credit summaries on the usage page and team detail page
  • Display user budget utilization when user budgets are enabled

Examples

  • Get current cumulative usage:
  • Get cumulative usage as of a specific date:

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.GetCumulativeCreditUsageRequest

Response

gitpod.v1.GetCumulativeCreditUsageResponse
CreditsByType contains credits consumed for a single usage type.gitpod.v1.CreditsByType
CumulativeCreditUsage contains cumulative credit consumption totals.gitpod.v1.CumulativeCreditUsage
gitpod.v1.EnterpriseAIUsageByModel
TeamCumulativeCreditUsage contains a team’s cumulative credit usage and allocation.gitpod.v1.TeamCumulativeCreditUsage
gitpod.v1.UserCreditBudgetUsage
UsageType identifies the category of usage.