Get LLM metrics summary

curl -X POST https://api.respan.ai/api/dashboard/llm-metrics/summary/ \
     -H "Authorization: Bearer sk_live_xxxxx" \
     -H "Content-Type: application/json" \
     -d '{
  "end_time": "2026-02-22T23:59:59Z",
  "start_time": "2026-02-01T00:00:00Z"
}'

{
  "number_of_requests": 15234,
  "total_cost": 1234.56,
  "total_prompt_tokens": 987654,
  "total_completion_tokens": 1234567,
  "total_tokens": 2222221,
  "error_count": 45,
  "error_percentage": 0.3,
  "average_prompt_tokens": 65,
  "average_completion_tokens": 81,
  "average_tokens": 146,
  "average_cost": 0.081,
  "average_tps": 12.5,
  "average_latency": 350.4,
  "average_ttft": 120.7,
  "prompt_cache_hit_tokens": 150000,
  "reasoning_tokens": 50000,
  "cache_hit_percentage": 12.4,
  "requests_per_second": 8.7
}

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

Headers

AuthorizationstringRequired

Bearer token. Use Bearer YOUR_API_KEY.

Request

This endpoint expects an object.

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. If provided, the response includes only these metric fields. If omitted, all LLM metrics are returned.

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.

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