Skip to main content

​
Endpoint

GET /leaderboard/team/first/{activity}/{version}
Ranking of the first 1000 completions of each activity version. This endpoint is useful for tracking world-first races and early completions.
For full contest mode rankings (not limited to first 1000), use the /leaderboard/team/contest/{raid} endpoint instead.

​
Path Parameters

​
activity
string
required
The activity identifier (path name). Examples:
  • vaultofglass
  • deepstone
  • kingsfail
  • rootofnightmares
  • salvationsedge
Use the /manifest endpoint to get all available activity paths.
​
version
string
required
The version identifier for the activity. Examples:
  • normal - Standard difficulty
  • master - Master difficulty
  • contest - Contest mode
Not all activities have all versions. Use /manifest to see valid activity-version combinations.

​
Query Parameters

​
count
integer
default:"50"
Number of entries to return per page. Must be between 10 and 100.
​
page
integer
default:"1"
Page number of leaderboard data. Ignored if search is provided. Must be greater than 0.
​
search
string
Search for a specific player by membershipId. Returns results centered around teams containing that player. Pattern: ^\d+n?$

​
Response

​
type
string
Always "team" for this endpoint
​
format
string
Always "duration" - values represent completion time in seconds
​
page
integer
Current page number
​
count
integer
Number of entries returned
​
entries
array
Array of team leaderboard entries

​
Example Request

curl --request GET \
  --url 'https://api.raidhub.io/leaderboard/team/first/salvationsedge/contest?count=10&page=1' \
  --header 'X-API-KEY: your_api_key'

​
Example Response

{
  "minted": "2024-03-15T12:00:00.000Z",
  "success": true,
  "response": {
    "type": "team",
    "format": "duration",
    "page": 1,
    "count": 10,
    "entries": [
      {
        "position": 1,
        "rank": 1,
        "value": 18523,
        "instanceId": "12345678901234567",
        "players": [
          {
            "membershipId": "4611686018488107374",
            "membershipType": 3,
            "bungieGlobalDisplayName": "WorldFirst1",
            "bungieGlobalDisplayNameCode": "0001",
            "iconPath": "/common/destiny2_content/icons/avatar1.jpg",
            "displayName": "WorldFirst1#0001",
            "lastSeen": "2024-03-15T11:00:00.000Z",
            "isPrivate": false,
            "cheatLevel": 0
          },
          {
            "membershipId": "4611686018488107375",
            "membershipType": 3,
            "bungieGlobalDisplayName": "WorldFirst2",
            "bungieGlobalDisplayNameCode": "0002",
            "iconPath": "/common/destiny2_content/icons/avatar2.jpg",
            "displayName": "WorldFirst2#0002",
            "lastSeen": "2024-03-15T11:00:00.000Z",
            "isPrivate": false,
            "cheatLevel": 0
          }
        ]
      }
    ]
  }
}

​
Error Responses

​
InvalidActivityVersionComboError
400
The activity and version combination is invalid
{
  "minted": "2024-03-15T12:00:00.000Z",
  "success": false,
  "code": "InvalidActivityVersionComboError",
  "error": {
    "activity": "vaultofglass",
    "version": "contest"
  }
}
​
PlayerNotOnLeaderboardError
404
Returned when searching for a player who is not on this leaderboard
​
PathValidationError
404
Invalid path parameters
​
QueryValidationError
400
Invalid query parameters

Build docs developers (and LLMs) love

Get started for freeTalk to us