dashboard

List LLM metrics

Returns LLM usage metrics (requests, tokens, cost, latency, cache hit rate, etc.) bucketed by time_tick (minute / hour / day).

post/api/dashboard/llm-metrics/

Query parameters

summary_type'daily' | 'weekly' | 'monthly' | 'quarterly' | 'yearly' | 'last_24h' | 'all'

Preset time range. Use this or explicit start_time / end_time.

datestring date

Base date used with summary_type presets.

start_timestring date-time

Optional explicit ISO start time.

end_timestring date-time

Optional explicit ISO end time.

time_tick'minute' | 'hour' | 'day'

Bucket granularity for time-series responses.

timezone_offsetnumber double

Timezone offset, in hours, used when resolving preset ranges.

fetch_filters'true' | 'false'

Whether to include available filter options in the response.

Headers

Authorizationstring required

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, OpenAI or Azure OpenAI provider credentials go in Settings -> Providers or the request body credential_override field, not in this auth field.

Request body

Response

Successful response.

date_groupstring date-time

Bucket start time, ISO 8601.

number_of_requestsinteger
total_costnumber double
total_prompt_tokensinteger
total_completion_tokensinteger
total_tokensinteger
error_countinteger
error_percentagenumber double
average_prompt_tokensinteger
average_completion_tokensinteger
average_tokensinteger
average_costnumber double
average_tpsnumber double
average_latencynumber double
average_ttftnumber double
prompt_cache_hit_tokensinteger
reasoning_tokensinteger
cache_hit_percentagenumber double
requests_per_secondnumber double

Changes