Get challenge leaderboard

Audience: NadeoClubServices

GET https://competition.trackmania.nadeo.club/api/challenges/{challengeId}/leaderboard?length={length}&offset={offset}

Path parameters:

  • {challengeId} (string) A valid challenge ID *

Query parameters:

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

Gets leaderboard entries for a challenge ID.


Remarks:

  • Note that challenges are different from competitions - challenges are separate leaderboard structures that can be part of a competition (for example in the form of a qualifying session).
  • Typically challenges are used for qualifiers in larger competitions - the relevant challengeId can be retrieved using the competition rounds endpoint.

Example request:

GET https://competition.trackmania.nadeo.club/api/challenges/409/leaderboard

Example response:

{
    "challengeId": 409,
    "cardinal": 399,
    "scoreUnit": "time",
    "results": [
        {
            "points": 38106,
            "player": "b90e91eb-bd87-41fd-8c69-6560dbeedd2e",
            "score": 38106,
            "rank": 1,
            "zone": "World|Europe|Poland|Kujawsko-Pomorskie"
        },
        {
            "points": 38156,
            "player": "dade4799-0761-41b7-8df1-cf413e5c8eef",
            "score": 38156,
            "rank": 2,
            "zone": "World|Asia|Brunei"
        },
        {
            "points": 38206,
            "player": "d46fb45d-d422-47c9-9785-67270a311e25",
            "score": 38206,
            "rank": 3,
            "zone": "World|Europe|Czechia|Středočeský kraj"
        },
        {
            "points": 38251,
            "player": "8f08302a-f670-463b-9f71-fbfacffb8bd1",
            "score": 38251,
            "rank": 4,
            "zone": "World|Europe|Germany|Saarland|Saarbrücken"
        },
        {
            "points": 38252,
            "player": "70bd004b-b948-4a9c-9013-4282487f035b",
            "score": 38252,
            "rank": 5,
            "zone": "World|Europe|France|Nouvelle-Aquitaine|Pyrénées-Atlantiques"
        },
        {
            "points": 38264,
            "player": "5c78b27a-908e-41f5-bce7-09e4367dbc0d",
            "score": 38264,
            "rank": 6,
            "zone": "World|North America|United States|Wisconsin"
        },
        {
            "points": 38278,
            "player": "9688a134-3562-470c-a06d-2275da464643",
            "score": 38278,
            "rank": 7,
            "zone": "World|Europe|Finland"
        },
        {
            "points": 38308,
            "player": "70e6f70b-5670-48d8-8551-fb8bb5181f03",
            "score": 38308,
            "rank": 8,
            "zone": "World|North America|Jamaica"
        },
        {
            "points": 38321,
            "player": "6b14adfa-90d6-486f-8c32-66756d4c93d5",
            "score": 38321,
            "rank": 9,
            "zone": "World|Europe|Poland|Lubelskie"
        },
        {
            "points": 38331,
            "player": "fcae33dd-70f2-4da1-b493-cd77c4399d0e",
            "score": 38331,
            "rank": 10,
            "zone": "World|South America|Brazil|São Paulo"
        }
    ]
}

If a challengeId is invalid, the response will contain a 404 response code.