API ReferenceDashboard

List metrics broken down by dimension

Returns a time series broken down by a chosen dimension (model, organization key, customer, prompt, deployment, or provider). Each row is one bucket with one column per dimension value. Top values are kept; the rest are folded into Others.

Headers

AuthorizationstringRequired

Bearer token. Use Bearer YOUR_API_KEY.

Request

This endpoint expects an object.
breakdown_byenumRequired
Dimension to break the time series down by.
end_timedatetimeRequired
Inclusive end of the range, ISO 8601.
start_timedatetimeRequired
Inclusive start of the range, ISO 8601.
filtersobjectOptional

Filter criteria. See Filters API Reference for operator syntax.

metrics_to_aggregatelist of enumsOptional

Optional metric subset (default: all metrics).

time_tickenumOptional

Bucket granularity for time-series endpoints. If omitted, inferred from the range. Has no effect on /summary/ endpoints.

Allowed values:

Response

Successful response.
date_groupdatetime