Skip to content

/v1/getLeaderboard

GET the current leaderboard

Parameters

Query Parameters

ParameterDescriptionRequired
typeType of leaderboard (1=sparks, 2=planets, 3=creatorPoints, 4=coins)No

Returns type=1 if no type is specified

Response

A leaderboard object with the following properties:

NameTypeDescription
accountIdnumberThe account ID of the user.
usernamestringThe username of the user.
sparksnumberThe sparks of the user.
planetsnumberThe planets of the user.
blueCoinsnumberThe blue coins of the user.
creatorPointsnumberThe creator points of the user.
isBoosternumberWhether the user is a booster.
isSupporternumberWhether the user is a supporter.
modRolenumberThe mod role of the user. (0=user, 1=mod, 2=admin)
ranknumberThe leaderboard rank of the user.

Other properties:

NameTypeDescription
totalAmountnumberThe total amount of users.
pagenumberThe current page number.
amountnumberThe number of users returned.
json
{
  "leaderboard": [
    {
      "accountId": 30631806,
      "username": "ExefMn",
      "sparks": 9111,
      "planets": 605,
      "blueCoins": 592,
      "creatorPoints": 4,
      "isBooster": false,
      "isSupporter": false,
      "modRole": 1,
      "rank": 1
    },
    {
      "accountId": 25313028,
      "username": "KonataIsBest",
      "sparks": 5901,
      "planets": 501,
      "blueCoins": 557,
      "creatorPoints": 6,
      "isBooster": false,
      "isSupporter": true,
      "modRole": 1,
      "rank": 2
    },
    {
      "accountId": 17018705,
      "username": "MonotonFXB",
      "sparks": 3525,
      "planets": 4,
      "blueCoins": 15,
      "creatorPoints": 2,
      "isBooster": false,
      "isSupporter": false,
      "modRole": 1,
      "rank": 3
    },
    ...
  ],
  "total": 2710,
  "page": 1,
  "amount": 100
}

Failed Response

Invalid type. Must be 1 (stars), 2 (planets), 3 (points) or 4 (coins)