Get favorite maps

Audience: NadeoLiveServices

GET https://live-services.trackmania.nadeo.live/api/token/map/favorite?offset={offset}&length={length}&sort={sort}&order={order}&mapType={mapType}&playable={playable}

Query parameters:

  • {offset} (integer) The number of maps to skip *
  • {length} (integer) The number of maps to retrieve *
  • {sort} (string) The sorting of the maps
    Default: date
  • {order} (string) The order of the maps based on the sorting
    Default: desc
  • {mapType} (string) The map type filter
  • {playable} (boolean) Whether the map is validated and playable

Retrieves your authenticated account's favorite tracks along with their information.


Remarks:

  • This endpoint is only useful with tokens authenticated through Ubisoft user accounts (as opposed to dedicated server accounts).
  • When no mapType filter is applied, all available maps are returned regardless of their type.
  • Examples of supported map types to filter by are "TrackMania\TM_Race", "TrackMania\TM_Royal" and "TrackMania\TM_Stunt".

Example request:

GET https://live-services.trackmania.nadeo.live/api/token/map/favorite?offset=0&length=1&sort=date&order=desc&mapType=Trackmania\TM_Race&playable=true

Example response:

{
  "mapList": [
    {
      "uid": "QleO8OiNAkIXrZs6r0YLSrLBjEi",
      "mapId": "606e4e16-f1d6-467c-9859-f1837a452166",
      "name": "MIDNIGHT METROPOLIS",
      "author": "144fce06-9b90-4af9-a5b0-9148bcc0566f",
      "submitter": "144fce06-9b90-4af9-a5b0-9148bcc0566f",
      "authorTime": 55910,
      "goldTime": 60000,
      "silverTime": 68000,
      "bronzeTime": 84000,
      "nbLaps": 0,
      "valid": false,
      "downloadUrl": "https://prod.trackmania.core.nadeo.online/storageObjects/9c20aff3-2046-4d7c-aa9b-52617d8d99e2",
      "thumbnailUrl": "https://prod.trackmania.core.nadeo.online/storageObjects/4889bf39-a4f3-40b2-a582-9fa926e41930.jpg",
      "uploadTimestamp": 1631578171,
      "updateTimestamp": 1658421115,
      "fileSize": null,
      "public": false,
      "favorite": false,
      "playable": true,
      "mapStyle": "TrackMania\\TM_Race",
      "mapType": "TrackMania\\TM_Race",
      "collectionName": "Stadium"
    }
  ],
  "itemCount": 1
}