Skip to content
dartpilot
Esc
↑↓navigate↵open⌘Jpreview

Get the current season

Returns the current quarterly season, its theme and the XP rules that govern standings.

GET/seasons
Authorization
x-api-keyAPI key · headerrequired

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

Responses
200

The current season and rules.

seasonSeasonSummaryrequired
Show properties
idstringrequired
numberintegerrequired
min -9007199254740991 · max 9007199254740991
namestringrequired
taglinestringrequired
themeKeystringrequired
accentany[]required
min items 2 · max items 2
startsAtstringrequired
endsAtstringrequired
rulesSeasonRulesrequired
Show properties
tierXpnumber[]required
tierCountintegerrequired
min -9007199254740991 · max 9007199254740991
xpSeasonXpRulesrequired
Show properties
tierCountintegerrequired
min -9007199254740991 · max 9007199254740991
matchobjectrequired
Show properties
basenumberrequired
perDartnumberrequired
capnumberrequired
minDartsnumberrequired
unknownDartsnumberrequired
winobjectrequired
Show properties
basenumberrequired
perExtraOpponentnumberrequired
maxFieldMultipliernumberrequired
botobjectrequired
Show properties
minWeightnumberrequired
maxWeightnumberrequired
maxLevelnumberrequired
competitiveobjectrequired
Show properties
rankednumberrequired
tournamentnumberrequired
dailyobjectrequired
Show properties
firstGamenumberrequired
firstWinnumberrequired
highlightsobjectrequired
Show properties
oneEightynumberrequired
oneFortynumberrequired
checkout100numberrequired
checkout130numberrequired
checkout170numberrequired
shanghainumberrequired
whiteHorsenumberrequired
capnumberrequired
nineDarternumberrequired
tournamentXpSeasonTournamentXpRulesrequired
Show properties
participationnumberrequired
perMatchWonnumberrequired
championPerRoundnumberrequired
runnerUpPerRoundnumberrequired
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
Authorization
Request
curl -X GET 'https://api.dartpilot.app/v1/seasons' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Accept: application/json'
Response
{
  "season": {
    "id": "string",
    "number": -9007199254740991,
    "name": "string",
    "tagline": "string",
    "themeKey": "string",
    "accent": [
      "string",
      "string"
    ],
    "startsAt": "string",
    "endsAt": "string"
  },
  "rules": {
    "tierXp": [
      0
    ],
    "tierCount": -9007199254740991,
    "xp": {
      "tierCount": -9007199254740991,
      "match": {
        "base": 0,
        "perDart": 0,
        "cap": 0,
        "minDarts": 0,
        "unknownDarts": 0
      },
      "win": {
        "base": 0,
        "perExtraOpponent": 0,
        "maxFieldMultiplier": 0
      },
      "bot": {
        "minWeight": 0,
        "maxWeight": 0,
        "maxLevel": 0
      },
      "competitive": {
        "ranked": 0,
        "tournament": 0
      },
      "daily": {
        "firstGame": 0,
        "firstWin": 0
      },
      "highlights": {
        "oneEighty": 0,
        "oneForty": 0,
        "checkout100": 0,
        "checkout130": 0,
        "checkout170": 0,
        "shanghai": 0,
        "whiteHorse": 0,
        "cap": 0,
        "nineDarter": 0
      }
    },
    "tournamentXp": {
      "participation": 0,
      "perMatchWon": 0,
      "championPerRound": 0,
      "runnerUpPerRound": 0
    }
  }
}

Was this page helpful?