List top providers | Respan Docs

Returns the top-N providers 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.

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.

limitintegerOptionalDefaults to 10

Maximum number of rows to return.

Request

This endpoint expects an object.

filtersobjectOptional

Filter criteria. See Filters API Reference for operator syntax.

Response

Successful response.

1	curl -X POST "https://api.respan.ai/api/dashboard/top-providers/?summary_type=weekly&sort_by=number_of_requests&limit=10" \
2	-H "Authorization: Bearer sk_live_xxxxx" \
3	-H "Content-Type: application/json" \
4	-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	}

Headers

Query parameters

Request

Response