Get LLM metrics summary

POST

https://api.respan.ai/api/dashboard/llm-metrics/summary/

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

Authentication

AuthorizationBearer

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.

Query parameters

summary_typeenumOptionalDefaults to all

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

datedateOptional

Base date used with summary_type presets.

start_timedatetimeOptional

Optional explicit ISO start time.

end_timedatetimeOptional

Optional explicit ISO end time.

time_tickenumOptionalDefaults to hour

Bucket granularity for time-series responses.

Allowed values:

timezone_offsetdoubleOptionalDefaults to 0

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

fetch_filtersenumOptionalDefaults to true

Whether to include available filter options in the response.

Allowed values:

Request

This endpoint expects an object.

filtersobjectOptional

Filter criteria. See Filters API Reference for operator syntax.

Response

Successful response.

number_of_requestsinteger

total_costdouble

total_prompt_tokensinteger

total_completion_tokensinteger

total_tokensinteger

error_countinteger

error_percentagedouble

average_prompt_tokensinteger

average_completion_tokensinteger

average_tokensinteger

average_costdouble

average_tpsdouble

average_latencydouble

average_ttftdouble

prompt_cache_hit_tokensinteger

reasoning_tokensinteger

cache_hit_percentagedouble

requests_per_seconddouble

$	curl -X POST https://api.respan.ai/api/dashboard/llm-metrics/summary/ \
>	-H "Authorization: Bearer <respanApiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"number_of_requests": 12500,
3	"total_cost": 345.75,
4	"total_prompt_tokens": 1500000,
5	"total_completion_tokens": 1200000,
6	"total_tokens": 2700000,
7	"error_count": 125,
8	"error_percentage": 1,
9	"average_prompt_tokens": 120,
10	"average_completion_tokens": 96,
11	"average_tokens": 216,
12	"average_cost": 0.0277,
13	"average_tps": 0.5,
14	"average_latency": 350.5,
15	"average_ttft": 120.3,
16	"prompt_cache_hit_tokens": 300000,
17	"reasoning_tokens": 500000,
18	"cache_hit_percentage": 11.1,
19	"requests_per_second": 3.2
20	}