IodidDOCUMENTATION

api/leaderboard/list.mdx

/doc/api/leaderboard/list

PUBLIC DOCUMENTATION

Leaderboard

Paginated and filtered leaderboard — rank, region, queue, role, otp.

GET/api/lol/leaderboard

Leaderboard page

Query params

Request
https://api.safjnest.com/api/lol/leaderboard?queue=RANKED_SOLO_5X5&page=1&limit=50
curl "https://api.safjnest.com/api/lol/leaderboard?queue=RANKED_SOLO_5X5&page=1&limit=50"
CORS enabled (*) — runs directly in your browser against https://api.safjnest.com

GET /api/lol/leaderboard

Paginated and filtered leaderboard. Each entry wraps SummonerView with position.

  • Controller: LeaderboardController.java:24 → LolApiParameters.queue/role/validateRole/rank/region/otpChampion/page/limit (:34) → leaderboardService.getLeaderboard → ApiResult<LeaderboardPage> → LolApiResponses.from with leaderboard_pending (:52)
  • Response: 200 LeaderboardPage with ResponseMetadata.pagination (:45) | 202 leaderboard_pending if computation is in progress

Query params

ParameterRequiredDefaultValidationFile:lineNotes
ranknonullrank :37TierType enum, null=all
regionnonullregion :155LeagueShard, UNKNOWN rejected
queuenoTEAM_BUILDER_RANKED_SOLO → canonical RANKED_SOLO_5X5queue :47GameQueueType, ALL→null
rolenonullrole :168 + validateRole :177TOP,JUNGLE,MID,BOT,UTILITY — rejected if !GameQueueTypeUtils.hasLane(queue)
otpnonullotpChampion :183integer >0 champion ID
pageno1page :198 >=1
limitno50limit :203 1..50

curl

bash
curl "https://api.safjnest.com/api/lol/leaderboard?queue=RANKED_SOLO_5X5&rank=CHALLENGER&region=EUW1&page=1&limit=20"
curl "https://api.safjnest.com/api/lol/leaderboard?queue=RANKED_SOLO_5X5&role=MID&otp=157&page=1&limit=50"