Leaderboards

One leaderboard per available ladder. The catalog is not paginated. Per-leaderboard entries are page-paginated, ranked by score (highest first).

Ids use the standard id.leaderboard.<slug> envelope, like every other resource: id.leaderboard.arena_season03.arena_solo_duo.arena. Each board also returns its human-readable season, mode, and metric directly.

GET/v2/leaderboards

Flat list of every leaderboard. No pagination. Each row carries id, state, season, mode, metric, began_at, ended_at, updated_at, num_entries.

began_at / ended_at are the live season window, sourced from the game's season catalog. An active season has a nullended_at. state is a lowercase enum: season, preseason.

GET/v2/leaderboards/{id}

idpath
Pick any leaderboard id from the list

Score-ranked entries for one leaderboard, wrapped alongside the board's leaderboard metadata and page / page_size / total. Each entry carries position, previous_position, character, character_id, class, rank, rank_level, karma, score.

pageoptional
1-based page number
Default
1
page_sizeoptional
Entries per page
Accepted
1 - 1000
Default
100