Skip to main content
Unary · Billing Returns a signed download URL for a CSV export of credit usage. The URL points to an HTTP endpoint that streams gzip-compressed CSV and is valid for five minutes. The download must be made by the same principal that requested it, carrying its own bearer token. The export range may cover up to a year. For organizations without enterprise credit usage enabled (no billing contract start date), the export instead contains BYOK cost usage with a different column set, and groupBy=RESOURCE is rejected. Use this method to:
  • Export per-user daily credit usage for external reporting
  • Export a per-environment and per-conversation resource breakdown

Examples

  • Export January’s daily summary:

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

Response

gitpod.v1.GetCreditUsageExportResponse
DateRange specifies a time period for queries.gitpod.v1.DateRange
How to group the credit usage export data.