Get matchmaking rankings

Audience: NadeoLiveServices

GET https://meet.trackmania.nadeo.club/api/matchmaking/{matchmakingType}/leaderboard?length={length}&offset={offset}

Path parameters:

  • {matchmakingType} (integer) The ID of the matchmaking type *

Query parameters:

  • {length} (integer) The number of ranks to retrieve
    Maximum: 100 Default: 10
  • {offset} (integer) The number of ranks to skip
    Default: 0

Gets global matchmaking rankings for the specified type.


Remarks:

  • The matchmakingType parameter is typically one of 2 (Ranked) or 3 (Royal). For a dynamic way of retrieving those IDs see the matchmaking summary endpoint.
  • This leaderboard doesn't have the same restrictions as the map leaderboard endpoints - you can request any position and will get an accurate rank for each player.
  • The cardinal field in the response is the total number of players in the ranking.

Example request:

GET https://meet.trackmania.nadeo.club/api/matchmaking/2/leaderboard?offset=10&length=5

Example response:

{
  "matchmakingId": 2,
  "cardinal": 1157847,
  "results": [
    {
      "player": "c0d0d93b-8396-40dd-a928-377c436e8a70",
      "rank": 11,
      "score": 4339
    },
    {
      "player": "bb4af693-5190-44c5-8448-d4ec36d95400",
      "rank": 12,
      "score": 4333
    },
    {
      "player": "ac935c32-4986-4af7-ac4d-ab4314101bc1",
      "rank": 13,
      "score": 4312
    },
    {
      "player": "a8bec23d-e5ba-47d3-8bb7-145b23d9650d",
      "rank": 14,
      "score": 4281
    },
    {
      "player": "3ea2b566-7097-4fbf-a91f-68de95adc232",
      "rank": 15,
      "score": 4271
    }
  ]
}

If the requested matchmakingType does not exist, the response will contain an error.