A valid request URL is required to generate request examples{
"total_requests": 123,
"total_tokens": 123,
"total_cost": 123,
"average_latency": 123,
"success_rate": 123,
"user_facing_success_rate": 123,
"user_facing_total_requests": 123,
"has_previous_period": true,
"cache_hit_rate_total_requests": 123,
"direct_cache_hits": 123,
"semantic_cache_hits": 123,
"previous": {
"total_requests": 123,
"total_tokens": 123,
"total_cost": 123,
"average_latency": 123,
"success_rate": 123,
"user_facing_success_rate": 123,
"user_facing_total_requests": 123,
"cache_hit_rate_total_requests": 123,
"direct_cache_hits": 123,
"semantic_cache_hits": 123
}
}{
"event_id": "<string>",
"type": "<string>",
"is_bifrost_error": true,
"status_code": 123,
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"event_id": "<string>"
},
"extra_fields": {
"provider": "openai",
"model_requested": "<string>",
"request_type": "<string>"
}
}{
"event_id": "<string>",
"type": "<string>",
"is_bifrost_error": true,
"status_code": 123,
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"event_id": "<string>"
},
"extra_fields": {
"provider": "openai",
"model_requested": "<string>",
"request_type": "<string>"
}
}Get log statistics
Returns statistics for logs matching the specified filters.
A valid request URL is required to generate request examples{
"total_requests": 123,
"total_tokens": 123,
"total_cost": 123,
"average_latency": 123,
"success_rate": 123,
"user_facing_success_rate": 123,
"user_facing_total_requests": 123,
"has_previous_period": true,
"cache_hit_rate_total_requests": 123,
"direct_cache_hits": 123,
"semantic_cache_hits": 123,
"previous": {
"total_requests": 123,
"total_tokens": 123,
"total_cost": 123,
"average_latency": 123,
"success_rate": 123,
"user_facing_success_rate": 123,
"user_facing_total_requests": 123,
"cache_hit_rate_total_requests": 123,
"direct_cache_hits": 123,
"semantic_cache_hits": 123
}
}{
"event_id": "<string>",
"type": "<string>",
"is_bifrost_error": true,
"status_code": 123,
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"event_id": "<string>"
},
"extra_fields": {
"provider": "openai",
"model_requested": "<string>",
"request_type": "<string>"
}
}{
"event_id": "<string>",
"type": "<string>",
"is_bifrost_error": true,
"status_code": 123,
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"event_id": "<string>"
},
"extra_fields": {
"provider": "openai",
"model_requested": "<string>",
"request_type": "<string>"
}
}Authorizations
Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <API key>.
Virtual keys, dashboard/user/session tokens, and x-api-key headers are not supported on management APIs.
Query Parameters
Comma-separated list of providers to filter by
Comma-separated list of models to filter by
Comma-separated list of statuses to filter by
Comma-separated list of object types to filter by
Comma-separated list of selected key IDs to filter by
Comma-separated list of virtual key IDs to filter by
Comma-separated list of routing rule IDs to filter by
Comma-separated list of routing engines to filter by (routing-rule, governance, or loadbalancing)
Start time filter (RFC3339 format)
End time filter (RFC3339 format)
Minimum latency filter
Maximum latency filter
Minimum tokens filter
Maximum tokens filter
Minimum cost filter
Maximum cost filter
Only show logs with missing cost
Search in request/response content
Exact lookup on a log ID (which is the request ID). Takes precedence over the time range — start_time/end_time/period are ignored when it is set. roots_only is ignored too, so an ID naming a fallback child returns that child rather than collapsing it into its root.
When true, also return the same statistics for the immediately preceding window of equal length, so callers can render change-vs-previous-period. Requires a bounded window of positive length (start_time and end_time, or period) and no request_id, since an id lookup matches one row regardless of the window. Where there is no preceding window to compare against, the response omits previous with has_previous_period false. A failure to compute the previous period degrades to has_previous_period false rather than failing the request.
Response
Successful response
Log statistics for the requested window. The current period's fields are at the top level, so a request without compare_to_previous returns the LogStats fields unchanged, plus has_previous_period false. has_previous_period is always present; previous appears only when a comparison was requested and computed.
Percentage of completed provider attempts that succeeded
Percentage of user requests that ultimately succeeded, counting fallback chains as one request
Count of root requests used as the denominator for user_facing_success_rate
Always present. True when previous is populated. False when the comparison was not requested, the window is unbounded, or the previous-period query failed.
Completed requests used as the local-cache hit-rate denominator
Number of direct local-cache hits
Number of semantic local-cache hits
The same statistics for the preceding window of equal length, ending immediately before the requested window starts. Present only when compare_to_previous is true and has_previous_period is true.
Show child attributes
Show child attributes
Was this page helpful?