Headers:

• Authorization: nadeo_v1 t={token} An access token for the NadeoLiveServices audience

Body parameters:

• {maps} object[] The list of maps (needs to match query parameters) *
  • {mapUid} string The UID of the map *
  • {groupUid} string The ID of the group/season for a specific map *

The request body contains an array of maps, each identified by its mapUid:

{
  "maps": [
    {
      "mapUid": mapUid,
      "groupUid": groupUid
    }
  ]
}

Gets the currently authenticated user's records on multiple maps.

Remarks:

• The groupUid "Personal_Best" can be used to get the global leaderboard.
• A maximum of 50 records may be requested. If more than 50 records are requested, only the first 50 will be returned.
• It may be possible for this endpoint to be delayed in the data it returns. This assumption is based on observations from similar endpoints, however it has not yet been extensively tested to confirm this.
• This is technically the same endpoint as get record positions by their time, but works differently if not given query parameters.
• This endpoint may sometimes return an empty list ([]) even when passed valid parameters. It is not known why but it seems to be inconsistent.

Example request:

POST https://live-services.trackmania.nadeo.live/api/token/leaderboard/group/map

{
  "maps": [
    {
      "mapUid": "Kn63nCh9bkaRHcZZsrtf_KcLMH2",
      "groupUid": "Personal_Best"
    }
  ]
}

Example response:

[
  {
    "groupUid": "Personal_Best",
    "mapUid": "Kn63nCh9bkaRHcZZsrtf_KcLMH2",
    "score": 19976,
    "zones": [
      {
        "zoneId": "301e1b69-7e13-11e8-8060-e284abfd2bc4",
        "zoneName": "World",
        "ranking": {
          "position": 7062,
          "length": 0
        }
      },
      {
        "zoneId": "301e2274-7e13-11e8-8060-e284abfd2bc4",
        "zoneName": "North America",
        "ranking": {
          "position": 1548,
          "length": 0
        }
      },
      {
        "zoneId": "3022ab53-7e13-11e8-8060-e284abfd2bc4",
        "zoneName": "United States",
        "ranking": {
          "position": 1208,
          "length": 0
        }
      },
      {
        "zoneId": "3022b270-7e13-11e8-8060-e284abfd2bc4",
        "zoneName": "Colorado",
        "ranking": {
          "position": 38,
          "length": 0
        }
      }
    ]
  }
]

If a mapUid is duplicated, the response will show duplicate results.

If a groupUid or mapUid is invalid, the response will omit that requested map.