List top users

POST

https://api.respan.ai/api/dashboard/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.

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_typeenumOptional

Preset time range. Use this OR start_time/end_time.

start_timedatetimeOptional

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

end_timedatetimeOptional

Optional explicit ISO end. Use with start_time.

sort_byenumOptionalDefaults to number_of_requests

Metric to sort the ranking by.

Request

This endpoint expects an object.

filtersobjectOptional

Filter criteria. See Filters API Reference for operator syntax.

Response

Successful response.

$	curl -X POST "https://api.respan.ai/api/dashboard/top-users/?summary_type=weekly&sort_by=number_of_requests" \
>	-H "Authorization: Bearer <respanApiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"number_of_requests": [
3	{
4	"model": "gpt-4o",
5	"number_of_requests": 123456
6	},
7	{
8	"model": "claude-sonnet-4",
9	"number_of_requests": 98765
10	}
11	]
12	}