4e064cf81dae

latestOpenAPI 3.1.02026-08-131831,331960.0 KB

dashboard

Get LLM metrics summary

Returns a single aggregated row of LLM metrics for the entire time range.

post/api/dashboard/llm-metrics/summary/

Query parameters

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, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

Request body

Response

Successful response.

number_of_requestsinteger

total_costnumber double

total_prompt_tokensinteger

total_completion_tokensinteger

total_tokensinteger

max_tpminteger

error_countinteger

error_percentagenumber double nullable

average_prompt_tokensnumber double nullable

average_completion_tokensnumber double nullable

average_tokensnumber double nullable

average_costnumber double nullable

average_latencynumber double nullable

average_tpsnumber double nullable

average_ttftnumber double nullable

prompt_cache_hit_tokensinteger

reasoning_tokensinteger

cache_hit_percentagenumber double nullable

requests_per_secondnumber double nullable

latencynumber double nullable

Legacy empty-bucket field.

time_to_first_tokennumber double nullable

Legacy empty-bucket field.