Skip to main content
GET
Get run analytics

Authorizations

Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Query Parameters

account_id
string<uuid>

Account to report; omitted, use the authorized context account or caller default. Requires account.billing.read.

preset
enum<string>
default:30d

Whole local days, defaulting to 30d. Explicit from/to bounds take precedence over preset, including SDK-supplied defaults.

Available options:
7d,
30d,
90d
from
string<date-time>

Inclusive start. Supply both from and to; these bounds take precedence over preset.

to
string<date-time>

Exclusive end, no later than the end of today in timezone.

timezone
string
default:UTC
granularity
enum<string>
default:day

UTC hours, or local calendar days, Monday-based weeks and months.

Available options:
hour,
day,
week,
month
group_by
enum<string>[]

Grouping dimensions supported by this operation. Repeat the parameter or use a comma-separated list.

Maximum array length: 4
Available options:
project,
model,
api_key,
member
compare
enum<string>

Compare preceding calendar months for whole-month custom ranges, local days for whole-day ranges and presets, or equal elapsed duration otherwise.

Available options:
previous_period
label
string[] | null

Project label filters as key or key=value, repeated or comma-separated.

project_reference
string

Optional project UUID or slug to scope analytics to a single project.

Response

Account run analytics statistics.

summary
object
required
timeframe
object
required
series
object[]
required
statuses
object[]
required
models
object[]
required
tools
object[]
required
projects
object[]
required
recent_runs
object[]
required
scope
object
group_by
enum<string>[]
Available options:
project