v12

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-014994227.2 KB
usage

Get usage metrics

Returns infrastructure cost and compute-minute summaries for the caller's user over a date range, plus per-bucket chart data. Granularity is hourly (≤24h window) or daily. Pass the window and granularity as query params.

get/usage/metrics

Query parameters

start_datestring date-time required

start of reporting window (RFC3339)

start of reporting window (RFC3339)

end_datestring date-time required

end of reporting window (RFC3339)

end of reporting window (RFC3339)

granularity'hourly' | 'daily'

bucket resolution

bucket resolution

timezonestring

IANA timezone for bucketing periods (e.g., America/Los_Angeles)

IANA timezone for bucketing periods (e.g., America/Los_Angeles)

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

granularity'hourly' | 'daily' required

Data resolution (hourly or daily).

period_endstring date-time required

End of the reporting period.

period_startstring date-time required

Beginning of the reporting period.

Example response

{
  "$schema": "/api/v1/UsageMetricsResponse.json"
}