Skip to main content
POST
Call Stats

Body

application/json

Request for aggregated call statistics over a time range.

project_id
string
required
start
string<date-time>
required

Inclusive start time (UTC, ISO 8601).

end
string<date-time> | null

Exclusive end time (UTC, ISO 8601). Defaults to now if omitted.

granularity
integer | null

Bucket size in seconds (e.g., 3600 for 1 hour). If omitted, auto-selected based on time range. Will be adjusted if it would produce more than 10,000 buckets.

usage_metrics
UsageMetricSpec · object[] | null

Usage metrics (tokens, cost) to compute. Grouped by timestamp and model.

call_metrics
CallMetricSpec · object[] | null

Call-level metrics (latency, counts) to compute. Grouped by timestamp only.

filter
CallsFilter · object | null
timezone
string
default:UTC

IANA timezone for bucket alignment (e.g., 'America/New_York')

Response

Successful Response

Response containing time-series call statistics.

start
string<date-time>
required

Resolved start time (UTC)

end
string<date-time>
required

Resolved end time (UTC)

granularity
integer
required

Bucket size used (in seconds)

timezone
string
required

Timezone used for bucket alignment

usage_buckets
Usage Buckets · object[]

Usage metrics by model. Each bucket contains 'timestamp', 'model', and aggregated metric values.

call_buckets
Call Buckets · object[]

Call-level metrics. Each bucket contains 'timestamp' and aggregated metric values.