Get a season leaderboard

Returns season standings ordered by XP, then games played. Use a season id such as s:2026-q4 or current; future or unknown seasons return 404.

GET/seasons/{id}/leaderboard

Authorization

x-api-keyAPI key · headerrequired

A user (dp_) or organization (dp_org_) API key with read scopes.

Path parameters

idstringrequired

Season id, such as s:2026-q4, or current.

Query parameters

limitinteger

Number of standings entries to return.

min 1 · max 250 · default: 100

Responses

200

The season standings.

seasonIdstringrequired

entriesSeasonLeaderboardEntry[]required

Show properties

Array of SeasonLeaderboardEntry

rankintegerrequired

max 9007199254740991

userIdstringrequired

displayNamestringrequired

imagestring | nullrequired

titlestring | nullrequired

totalXpintegerrequired

min 0 · max 9007199254740991

currentTierintegerrequired

min 0 · max 9007199254740991

gamesPlayedintegerrequired

min 0 · max 9007199254740991

winsintegerrequired

min 0 · max 9007199254740991

400

Invalid request.

messagestringrequired

401

Missing or invalid API key.

messagestringrequired

403

The API key is missing a required scope or is the wrong type for this endpoint.

messagestringrequired

404

Entity not found.

messagestringrequired

429

Rate limit exceeded. See the Retry-After header.

messagestringrequired

500

Internal server error.

messagestringrequired

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

API keyRemember on this deviceInclude my values in samples

Parameters

idpath*Season id, such as `s:2026-q4`, or `current`.limitqueryNumber of standings entries to return.

Request

curl -X GET 'https://api.dartpilot.app/v1/seasons/string/leaderboard' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Accept: application/json'

const response = await fetch("https://api.dartpilot.app/v1/seasons/string/leaderboard", {
  method: "GET",
  headers: {
    "x-api-key": "YOUR_API_KEY",
    "Accept": "application/json"
  }
});

import requests

response = requests.get(
    "https://api.dartpilot.app/v1/seasons/string/leaderboard",
    headers={
        "x-api-key": "YOUR_API_KEY",
        "Accept": "application/json"
    },
)

Response

{
  "seasonId": "string",
  "entries": [
    {
      "rank": 1,
      "userId": "string",
      "displayName": "string",
      "image": "string",
      "title": "string",
      "totalXp": 0,
      "currentTier": 0,
      "gamesPlayed": 0,
      "wins": 0
    }
  ]
}

{
  "message": "string"
}

{
  "message": "string"
}

{
  "message": "string"
}

{
  "message": "string"
}

{
  "message": "string"
}

{
  "message": "string"
}