Get cache hit summary

Returns cache hit metrics aggregated over the 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.

Response

Successful response.

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

1	{
2	"total_requests": 12500,
3	"cache_hits": 8750,
4	"cache_miss": 3750,
5	"hit_rate": 0.7,
6	"time_range_start": "2024-06-01T00:00:00Z",
7	"time_range_end": "2024-06-07T23:59:59Z",
8	"summary_type": "weekly",
9	"time_tick": "hour",
10	"timezone_offset": -4
11	}