Get competitions

Audience: NadeoLiveServices

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

Query parameters:

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

Gets a list of competitions.


Remarks:

  • The response includes Super Royal and COTD instances as well as community-made competitions.

Example request:

GET https://meet.trackmania.nadeo.club/api/competitions?length=3&offset=5

Example response:

[
  {
    "id": 3633,
    "liveId": "LID-COMP-4uviu3rgnjxr4yx",
    "creator": "bb961ea9-bb72-49c2-9294-fb0a34fb7591",
    "name": "Baltic Weekly #2",
    "participantType": "PLAYER",
    "description": "Single Elimination Cup mode event for all Baltic players.\n\n Format\nTime Attack -> (Top 16) Single Elimination Cup Mode\nMaps: FastPoint",
    "registrationStart": 1663399920,
    "registrationEnd": 1663422900,
    "startDate": 1663425300,
    "endDate": 1663431300,
    "matchesGenerationDate": null,
    "nbPlayers": 8,
    "spotStructure": "{\"version\":0,\"rounds\":[{\"matchGeneratorData\":{\"matches\":[{\"spots\":[{\"roundPosition\":0,\"rank\":1,\"spotType\":\"round_challenge_participant\"},{\"roundPosition\":0,\"rank\":8,\"spotType\":\"round_challenge_participant\"},{\"roundPosition\":0,\"rank\":9,\"spotType\":\"round_challenge_participant\"},{\"roundPosition\":0,\"rank\":16,\"spotType\":\"round_challenge_participant\"}],\"settings\":[]},{\"spots\":[{\"roundPosition\":0,\"rank\":4,\"spotType\":\"round_challenge_participant\"},{\"roundPosition\":0,\"rank\":5,\"spotType\":\"round_challenge_participant\"},{\"roundPosition\":0,\"rank\":12,\"spotType\":\"round_challenge_participant\"},{\"roundPosition\":0,\"rank\":13,\"spotType\":\"round_challenge_participant\"}],\"settings\":[]},{\"spots\":[{\"roundPosition\":0,\"rank\":2,\"spotType\":\"round_challenge_participant\"},{\"roundPosition\":0,\"rank\":7,\"spotType\":\"round_challenge_participant\"},{\"roundPosition\":0,\"rank\":10,\"spotType\":\"round_challenge_participant\"},{\"roundPosition\":0,\"rank\":15,\"spotType\":\"round_challenge_participant\"}],\"settings\":[]},{\"spots\":[{\"roundPosition\":0,\"rank\":3,\"spotType\":\"round_challenge_participant\"},{\"roundPosition\":0,\"rank\":6,\"spotType\":\"round_challenge_participant\"},{\"roundPosition\":0,\"rank\":11,\"spotType\":\"round_challenge_participant\"},{\"roundPosition\":0,\"rank\":14,\"spotType\":\"round_challenge_participant\"}],\"settings\":[]}]},\"matchGeneratorType\":\"spot_filler\"},{\"matchGeneratorData\":{\"matches\":[{\"spots\":[{\"roundPosition\":0,\"matchPosition\":0,\"rank\":1,\"spotType\":\"match_participant\"},{\"roundPosition\":0,\"matchPosition\":1,\"rank\":2,\"spotType\":\"match_participant\"},{\"roundPosition\":0,\"matchPosition\":2,\"rank\":4,\"spotType\":\"match_participant\"},{\"roundPosition\":0,\"matchPosition\":3,\"rank\":1,\"spotType\":\"match_participant\"}],\"settings\":[]},{\"spots\":[{\"roundPosition\":0,\"matchPosition\":3,\"rank\":2,\"spotType\":\"match_participant\"},{\"roundPosition\":0,\"matchPosition\":2,\"rank\":1,\"spotType\":\"match_participant\"},{\"roundPosition\":0,\"matchPosition\":1,\"rank\":1,\"spotType\":\"match_participant\"},{\"roundPosition\":0,\"matchPosition\":0,\"rank\":2,\"spotType\":\"match_participant\"}],\"settings\":[]}]},\"matchGeneratorType\":\"spot_filler\"},{\"matchGeneratorData\":{\"matches\":[{\"spots\":[{\"roundPosition\":1,\"matchPosition\":0,\"rank\":1,\"spotType\":\"match_participant\"},{\"roundPosition\":1,\"matchPosition\":1,\"rank\":1,\"spotType\":\"match_participant\"},{\"roundPosition\":1,\"matchPosition\":1,\"rank\":2,\"spotType\":\"match_participant\"},{\"roundPosition\":1,\"matchPosition\":0,\"rank\":2,\"spotType\":\"match_participant\"}],\"settings\":[]}]},\"matchGeneratorType\":\"spot_filler\"}]}",
    "leaderboardId": 9109,
    "manialink": null,
    "rulesUrl": "https://discord.gg/G9nr3Pa",
    "streamUrl": null,
    "websiteUrl": null,
    "logoUrl": "https://trackmania-prod-club-public.s3.eu-west-1.amazonaws.com/competitions/club/315965/logo/odckbboirc4wbs53pe4o.png",
    "verticalUrl": null,
    "allowedZones": [
      "World|Europe|Latvia",
      "World|Europe|Estonia",
      "World|Europe|Lithuania"
    ],
    "deletedOn": null,
    "autoNormalizeSeeds": true,
    "region": null,
    "autoGetParticipantSkillLevel": "DISABLED",
    "matchAutoMode": "START"
  },
  {
    "id": 3631,
    "liveId": "LID-COMP-j4euw3yc3cawoxs",
    "creator": "afe7e1c1-7086-48f7-bde9-a7e320647510",
    "name": "Cup of the Day 2022-09-16 #3",
    "participantType": "PLAYER",
    "description": null,
    "registrationStart": null,
    "registrationEnd": null,
    "startDate": 1663406190,
    "endDate": 1663413390,
    "matchesGenerationDate": 1663406165,
    "nbPlayers": 280,
    "spotStructure": "{\"version\":1,\"rounds\":[{\"matchGeneratorData\":{\"matchSize\":64,\"matchGeneratorType\":\"daily_cup\"},\"matchGeneratorType\":\"daily_cup\"}]}",
    "leaderboardId": 9093,
    "manialink": null,
    "rulesUrl": null,
    "streamUrl": null,
    "websiteUrl": null,
    "logoUrl": null,
    "verticalUrl": null,
    "allowedZones": [],
    "deletedOn": null,
    "autoNormalizeSeeds": true,
    "region": "eu-west",
    "autoGetParticipantSkillLevel": "DISABLED",
    "matchAutoMode": "ENABLED"
  },
  {
    "id": 3627,
    "liveId": "LID-COMP-zaarrvawzmixnpv",
    "creator": "afe7e1c1-7086-48f7-bde9-a7e320647510",
    "name": "Super royal 2022-09-16 #2",
    "participantType": "TEAM",
    "description": null,
    "registrationStart": null,
    "registrationEnd": null,
    "startDate": 1663381260,
    "endDate": 1663388400,
    "matchesGenerationDate": 1663381260,
    "nbPlayers": 45,
    "spotStructure": "{\"version\":1,\"rounds\":[{\"matchGeneratorType\":\"super_royal_first_round\"},{\"matchGeneratorType\":\"super_royal_next_round\"},{\"matchGeneratorType\":\"super_royal_next_round\"},{\"matchGeneratorType\":\"super_royal_next_round\"}]}",
    "leaderboardId": 9081,
    "manialink": null,
    "rulesUrl": null,
    "streamUrl": null,
    "websiteUrl": null,
    "logoUrl": null,
    "verticalUrl": null,
    "allowedZones": [],
    "deletedOn": null,
    "autoNormalizeSeeds": false,
    "region": null,
    "autoGetParticipantSkillLevel": "DISABLED",
    "matchAutoMode": "ENABLED"
  }
]

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