Get 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, 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.

AuthorizationBearer

Use a dashboard JWT only for dashboard-authenticated endpoints. Respan API-key endpoints use the respanApiKey auth field instead.

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_requestsintegerOptional

total_costdoubleOptional

total_prompt_tokensintegerOptional

total_completion_tokensintegerOptional

total_tokensintegerOptional

max_tpmintegerOptional

error_countintegerOptional

error_percentagedouble or nullOptional

average_prompt_tokensdouble or nullOptional

average_completion_tokensdouble or nullOptional

average_tokensdouble or nullOptional

average_costdouble or nullOptional

average_latencydouble or nullOptional

average_tpsdouble or nullOptional

average_ttftdouble or nullOptional

prompt_cache_hit_tokensintegerOptional

reasoning_tokensintegerOptional

cache_hit_percentagedouble or nullOptional

requests_per_seconddouble or nullOptional

latencydouble or nullOptional

Legacy empty-bucket field.

time_to_first_tokendouble or nullOptional

Legacy empty-bucket field.