Leaderboard ranks
Tier metadata for leaderboard scoring (Apprentice, Adept, Mythic, ...). Time-travel with ?at_patch= + ?branch= (see Patches).
Sits under /leaderboards/ranks rather than /ranks — it's leaderboard-scoped metadata, not a separate top-level resource. See Leaderboards for the entries surface that references these ranks.
Endpoints
GET /v2/leaderboards/ranks list
GET /v2/leaderboards/ranks/{id} single rank
GET /v2/leaderboards/ranks/{id}/icon → 302 redirect to the asset endpoint
Query parameters
| Name | Mode | Description |
|---|---|---|
id | exact | id.leaderboard_rank.<slug> (e.g. apprentice_i) |
name | substring | matches the display name |
group | exact | id.leaderboard_rank_group.<slug> (e.g. apprentice) |
min_sub_grade, max_sub_grade | range | sub-grade index within the group (1..N) |
at_patch | version | render this entity at the named patch's version |
branch | string | branch (default main) |
page, limit | pagination | default 25, max 250 |
Example
curl 'https://api.darkerdb.com/v2/leaderboards/ranks/id.leaderboard_rank.apprentice_i'
{
"body": {
"id": "id.leaderboard_rank.apprentice_i",
"patch_version": "0.16.135.8645-2663",
"source_key": "Id_LeaderboardRank_Apprentice_I",
"art_data": "LeaderboardRank_Apprentice_I",
"rank_name": "Text_LeaderboardRank_Apprentice_I",
"rank_sub_grade": 3,
"leaderboard_rank_group": "id.leaderboard_rank_group.apprentice",
"leaderboard_rank_a_ps": [ "Id_LeaderboardRankAP_SoloHighRoller_Apprentice_I", "..." ],
"leaderboard_rank_e_fs": [ "Id_LeaderboardRankEF_GoblinNormal_Apprentice_I", "..." ]
}
}
rank_name is a localization key. leaderboard_rank_a_ps (entry-point bindings) and leaderboard_rank_e_fs (eligibility filters) are raw upstream key arrays — no canonical type is registered for them, so they pass through unwrapped.