Skip to main content
GET
Deployment-wide bucketed cost summary
cost:read must be held at the deployment root, not only where the credential acts; see Deployment-root authority. meta.partial is always present; see Completeness.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Query Parameters

bucket
enum<string>
required

Aggregation granularity.

Available options:
hourly,
daily,
weekly,
monthly
startTime
integer
required

Range start, epoch-ms.

endTime
integer
required

Range end, epoch-ms. Must be >= startTime.

interfaceId
string

Restrict to one interface. See the interfaceId caveat above before relying on this.

Response

Cost aggregate rows for the requested bucket and range

data
object[]
required
meta
object
required