Sign in
dashboard

List top users

Returns the top-N customer identifiers ranked by a chosen LLM metric. Pass a filters body to scope the ranking (for example to a single customer or model). Authenticated; regular users are scoped to their own organization.

post/api/dashboard/top-users/

Query parameters

summary_type'daily' | 'weekly' | 'monthly' | 'quarterly' | 'yearly' | 'last_24h'

Preset time range. Use this OR start_time/end_time.

start_timestring date-time

Optional explicit ISO start. Use with end_time for custom ranges.

end_timestring date-time

Optional explicit ISO end. Use with start_time.

sort_by'number_of_requests' | 'total_cost' | 'total_prompt_tokens' | 'total_completion_tokens' | 'total_tokens' | 'error_count' | 'error_percentage' | 'average_prompt_tokens' | 'average_completion_tokens' | 'average_tokens' | 'average_cost' | 'average_tps' | 'average_latency' | 'average_ttft' | 'prompt_cache_hit_tokens' | 'reasoning_tokens' | 'cache_hit_percentage' | 'requests_per_second'

Metric to sort the ranking by.

Headers

Authorizationstring required

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.

Request body

Response

Successful response.

DashboardTopNResponse required

Map of metric name -> ranked array. The keys are the values of the sort_by parameter (default: number_of_requests). Each row contains the dimension value (model name, key id, etc.) and the metric value.

Changes