Get map info (multiple) by IDs

GET https://prod.trackmania.core.nadeo.online/maps/by-id/?mapIdList={mapIdList}

Headers:


Query parameters:

  • {mapIdList} (string) A comma-separated list of map IDs *

This endpoint is not the same as the deprecated map info (multiple) endpoint - note the changed endpoint route.

Gets information about multiple maps via their IDs.


Remarks:

  • This endpoint only accepts mapIds - the map info (multiple) by UID endpoint offers the same functionality for mapUids.
  • This endpoint has no intrinsic limit on the number of map IDs requested, but it will return a 414 error if the request URI length is 8220 characters or more (corresponding to just over 200 map IDs, depending on how you encode the URI).
  • This endpoint behaves the same as the deprecated map info (multiple) endpoint.

Example request:

GET https://prod.trackmania.core.nadeo.online/maps/by-id/?mapIdList=a74716be-d124-4de1-87c2-834304ccef5b,5546883f-b1ed-49e0-9397-55fc46f1d00c

Example response:

[
  {
    "author": "7cd60a75-609a-4e64-b286-16f329878249",
    "authorScore": 26972,
    "bronzeScore": 41000,
    "collectionName": "Stadium",
    "createdWithGamepadEditor": false,
    "createdWithSimpleEditor": false,
    "fileUrl": "https://core.trackmania.nadeo.live/maps/5546883f-b1ed-49e0-9397-55fc46f1d00c/file",
    "filename": "SnowIsBack.Map.Gbx",
    "goldScore": 29000,
    "isPlayable": true,
    "mapId": "5546883f-b1ed-49e0-9397-55fc46f1d00c",
    "mapStyle": "",
    "mapType": "TrackMania\\TM_Race",
    "mapUid": "k45jQI6Y7XrPfe1T0hZhj4pKzY2",
    "name": "SnowIsBack",
    "silverScore": 33000,
    "submitter": "7cd60a75-609a-4e64-b286-16f329878249",
    "thumbnailUrl": "https://core.trackmania.nadeo.live/maps/5546883f-b1ed-49e0-9397-55fc46f1d00c/thumbnail.jpg",
    "timestamp": "2023-11-21T16:50:01+00:00"
  },
  {
    "author": "73eba009-a074-4439-916f-d25d7fa7bc1c",
    "authorScore": 102399,
    "bronzeScore": 154000,
    "collectionName": "Stadium",
    "createdWithGamepadEditor": false,
    "createdWithSimpleEditor": false,
    "fileUrl": "https://core.trackmania.nadeo.live/maps/a74716be-d124-4de1-87c2-834304ccef5b/file",
    "filename": "Laserhawk - Megacity Race.Map.Gbx",
    "goldScore": 109000,
    "isPlayable": true,
    "mapId": "a74716be-d124-4de1-87c2-834304ccef5b",
    "mapStyle": "",
    "mapType": "TrackMania\\TM_Race",
    "mapUid": "cmJJhEUYqesM6Tqpeds0lQudvOb",
    "name": "$i$a1bLaserhawk $fff- Megacity Race",
    "silverScore": 123000,
    "submitter": "7ad33388-641e-4497-b063-c88e75552645",
    "thumbnailUrl": "https://core.trackmania.nadeo.live/maps/a74716be-d124-4de1-87c2-834304ccef5b/thumbnail.jpg",
    "timestamp": "2023-10-23T17:05:25+00:00"
  }
]

If a mapId is invalid, that map will not be returned in the response.