Skip to main content
GET
Get usage

Authorizations

Authorization
string
header
required

An API key (zode_tok_...). Create one in the console under API keys (https://console.zode.dev/tokens), or with zode login.

Query Parameters

from
string<date>

First UTC day (YYYY-MM-DD). Default 29 days before to.

to
string<date>

Last UTC day, inclusive (YYYY-MM-DD). Default today. At most 92 days in all.

group_by
enum<string>
default:repo
Available options:
repo,
branch,
pr,
member,
sandbox,
model

Response

Usage

from
string<date>
required
to
string<date>
required
as_of
string<date-time>
required

The range end, clipped to now.

group_by
enum<string>
required
Available options:
repo,
branch,
pr,
member,
sandbox,
model
totals
object
required
series
object[]
required

One entry per day of the range, zeros included.

groups
object[]
required

Most expensive first. Key "" is unattributed usage (no repo, branch or PR; by model, compute and storage).

ai_by_model
object[]
required
ai_billed
boolean
required
recorder
enum<string>
required
Available options:
on,
off,
error
price_versions
string[]
required