Skip to main content
GET

Authorizations

​
Authorization
string
header
required

Primary scheme: Authorization: Key <key_id>:<secret>.

Query Parameters

​
start
string<date-time> | null

Window start (inclusive, ISO-8601); defaults to 7 days before end. Bounds job-creation time.

​
end
string<date-time> | null

Window end (exclusive, ISO-8601); defaults to now. The window is capped at 90 days.

​
group_by
enum<string>
default:total

One summary row (total), one per UTC day (day), or one per model (model).

Available options:
total,
day,
model

Response

Successful Response

​
start
string<date-time>
required

Window start (inclusive).

​
end
string<date-time>
required

Window end (exclusive).

​
group_by
enum<string>
required
Available options:
total,
day,
model
​
total_jobs
integer
required

Jobs submitted across the whole window.

​
total_spent
number
required

Net amount spent across the whole window.

​
currency
string
required

ISO-4217 currency code for every amount in this response.

​
data
UsageBucket · object[]

One bucket per group_by group.