Overview
RaidHub provides multiple types of leaderboards to rank players and teams across various categories. These leaderboards allow you to find top performers, search for specific players, and track competitive rankings.Leaderboard Types
Individual Global
Rankings across all raids (clears, fresh clears, sherpas, time played, speed)
Individual Raid
Rankings for specific raids (clears, fresh clears, sherpas)
Individual Pantheon
Rankings for specific Pantheon versions (clears, fresh clears, score)
Team Contest
World first race rankings for contest mode completions
Team First
First clear leaderboards for specific activity versions
Clan
Clan rankings based on various metrics
Individual Global Leaderboards
Global leaderboards rank players across all raid activities.Available Categories
clears- Total raid completionsfreshClears- Total fresh raid completionssherpas- Total sherpa runs (carrying first-timers)timeInRaids- Total time spent in raidsspeed- Sum of best times across all raidscontest- World first race score
Querying Global Leaderboards
Global Leaderboard Parameters
Leaderboard category:
clears, freshClears, sherpas, timeInRaids, speed, or contestPage number (1-indexed)
Number of entries per page (10-100)
Membership ID to search for. Returns entries centered around the player’s rank.
Example Response
Individual Raid Leaderboards
Raid-specific leaderboards rank players within a single raid activity.Available Categories
clears- Total completions of the raidfreshClears- Fresh completions onlysherpas- Sherpa runs
Querying Raid Leaderboards
Common Raid Slugs
last-wishgarden-of-salvationdeep-stone-cryptvault-of-glassvow-of-the-disciplekings-fallroot-of-nightmarescrotas-endsalvations-edge
Raid slugs are lowercase with hyphens. If unsure of the slug, check the RaidHub website or API documentation.
Individual Pantheon Leaderboards
Pantheon leaderboards rank players for specific Pantheon versions.Available Categories
clears- Total completionsfreshClears- Fresh completionsscore- Highest score achieved
Querying Pantheon Leaderboards
Team Contest Leaderboards
Team contest leaderboards rank teams that completed the raid during the official contest period (typically 24-48 hours after raid launch).Querying Team Contest Leaderboards
Team Leaderboard Response
The
value field for team leaderboards represents completion time in seconds. The format field indicates this is a duration-based leaderboard.Team First Leaderboards
These leaderboards show the first teams to complete a specific activity version, regardless of whether it was during contest mode.Querying Team First Leaderboards
Clan Leaderboards
Clan leaderboards rank Destiny 2 clans based on various metrics.Available Columns
weighted_contest_score(default) - Contest performance score- Other clan-specific metrics
Querying Clan Leaderboards
Clan Leaderboard Parameters
Page number (1-indexed)
Number of entries per page (10-100)
Sort column for clan rankings
Pagination
All leaderboards use page-based pagination.How Pagination Works
Pagination Example
Searching for Players
When using thesearch parameter with a membership ID, the API returns entries centered around the player’s rank.
Search Behavior
Understanding Response Formats
Leaderboards return different formats based on the type of data:- Numerical
- Duration
- Percentage
Used for count-based leaderboards (clears, sherpas, etc.)
Common Use Cases
Finding Top Players in a Raid
Checking a Player’s Global Rank
Viewing World First Teams
Error Handling
The searched player does not appear on this leaderboard
The specified raid slug is invalid
The specified Pantheon version is invalid
Best Practices
Cache Leaderboards
Leaderboards are cached for 15 seconds server-side. Cache on your end too.
Use Appropriate Count
Request only the number of entries you need to reduce response size
Handle 404s
Not all players appear on all leaderboards - handle NotOnLeaderboardError
Check Format Field
Use the
format field to properly display values (duration vs numerical)Related Endpoints
Player Data
Get detailed player profiles and statistics
Instance Data
View details of specific raid completions