Skip to main content
GET
Account Usage
Use the declared scope and time parameters below to request aggregate usage. See Usage and Logs for the Console workflow and per-request records.

Request contract

Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

start_time
integer<int64>
required

Window start as a Unix timestamp in seconds.

end_time
integer<int64>

Window end as a Unix timestamp in seconds. Defaults to the current time.

Response

Usage totals and per-day buckets over the window.

scope
string

Aggregation scope implied by the credential (e.g. key or account).

currency
string

ISO currency code (always USD).

start_time
integer<int64>

Echoed window start (Unix seconds).

end_time
integer<int64>

Echoed window end (Unix seconds).

bucket_width
string

Bucket granularity (e.g. 1d).

totals
object

Aggregate totals across the whole window.

buckets
object[]

Per-bucket usage, ordered by time.