v1

latestOpenAPI 3.1.0Apache 2.02026-07-264001921002.3 KB

Logging

Get cost histogram by dimension

Returns time-bucketed cost data grouped by an arbitrary dimension (provider, team_id, customer_id, user_id, business_unit_id). The dimension is supplied via the required dimension query parameter.

get/api/logs/histogram/cost/by-dimension

Query parameters

dimension'provider' | 'team_id' | 'customer_id' | 'user_id' | 'business_unit_id' required

Grouping dimension for dimension-aware histograms. Used by the /api/logs/histogram/{cost,tokens,latency}/by-dimension endpoints.

Grouping dimension

providersstring

Comma-separated list of providers to filter by

modelsstring

Comma-separated list of models to filter by

statusstring

Comma-separated list of statuses to filter by

objectsstring

Comma-separated list of object types to filter by

selected_key_idsstring

Comma-separated list of selected key IDs to filter by

virtual_key_idsstring

Comma-separated list of virtual key IDs to filter by

routing_rule_idsstring

Comma-separated list of routing rule IDs to filter by

routing_engine_usedstring

Comma-separated list of routing engines to filter by

start_timestring date-time

Start time filter (RFC3339 format)

end_timestring date-time

End time filter (RFC3339 format)

min_latencynumber

Minimum latency filter

max_latencynumber

Maximum latency filter

min_tokensinteger

Minimum tokens filter

max_tokensinteger

Maximum tokens filter

min_costnumber

Minimum cost filter

max_costnumber

Maximum cost filter

missing_cost_onlyboolean

Only show logs with missing cost

content_searchstring

Search in request/response content

Response

Dimension cost histogram retrieved successfully

bucket_size_secondsinteger

dimension'provider' | 'team_id' | 'customer_id' | 'user_id' | 'business_unit_id'

Grouping dimension for dimension-aware histograms. Used by the /api/logs/histogram/{cost,tokens,latency}/by-dimension endpoints.

dimension_valuesstring[]