Get favorite maps

GET https://prod.trackmania.core.nadeo.online/maps/favorites?offset={offset}&length={length}&sort={sort}&order={order}&mapTypeList={mapTypeList}&playable={playable}&onlyMine={onlyMine}

Headers:


Query parameters:

  • {offset} integer The number of maps to skip *
  • {length} integer The number of maps to retrieve *
    Minimum: 1
  • {sort} string The sorting of the maps
    Default: date
  • {order} string The order of the maps based on the sorting
    Default: desc
  • {mapTypeList} string The map type filter separated by commas
  • {playable} boolean Whether the map is validated and playable
  • {onlyMine} boolean Whether the map was created by the current authenticated account

Retrieves your authenticated account's favorite tracks.


Remarks:

  • This endpoint is only useful with tokens authenticated through Ubisoft user accounts (as opposed to dedicated server accounts).
  • The sort parameter can be set to "date" (when the map was added to your favorite tracks) or "name" (the map name).
  • When no mapTypeList filter is applied, all available maps are returned regardless of their type.
  • See the glossary for examples of supported map types.
  • The timestamp field is when the map was added to your favorite tracks.
  • This endpoint behaves similarly to the Live API's Get favorite map endpoint, but the response data model is different, with the Live endpoint also including additional map information.

Example request:

GET https://prod.trackmania.core.nadeo.online/maps/favorites?offset=0&length=1&sort=date&order=desc&mapTypeList=Trackmania\TM_Race&playable=true&onlyMine=false

Example response:

{
  "mapFavoriteList": [
    {
      "accountId": "69f31664-4252-48e0-a433-024c49caee8c",
      "mapUid": "KRelvYHRjEQoqnkJ_Th8FLKzTsg",
      "timestamp": "2026-02-13T20:58:41+00:00"
    }
  ],
  "count": 11
}