Core API

This is the main API the game talks to. Most of its endpoints require a token with the NadeoServices audience.

Through this API, tokens for specific audiences can be requested (see Authentication).

Deprecations

• The display names endpoint has been removed on 2023-09-19 - to continue resolving accountID values to user names, it's recommended to use the relevant OAuth API endpoint instead.

Endpoints list

There is an endpoint that provides all of the available endpoints. It does not require any authentication, and as such can be viewed directly in the browser.

Tokens authenticated through dedicated server accounts as described in Authentication can not use certain APIs. You can view which APIs those are by using the usage parameter. This means there are 3 endpoints to query:

• https://prod.trackmania.core.nadeo.online/api/routes - Shows all available endpoints
• https://prod.trackmania.core.nadeo.online/api/routes?usage=Client - Shows endpoints intended for clients
• https://prod.trackmania.core.nadeo.online/api/routes?usage=Server - Shows endpoints intended for servers

Dedicated server accounts do not have access to all accounts-related endpoints, which is why it's recommended to use the Ubisoft authentication method rather than the dedicated server method.

Endpoints history

We are tracking this endpoint API through Github for changes Nadeo makes in real time. This is also pushed to Discord in our #announce channel.

• Accounts
  • Get player club tags
  • Get player display names
  • Get player webIdentities
  • Get player zones
• Maps
  • Get authored maps
  • Get map info
  • Get map info (multiple)
  • Get submitted maps
• Meta
  • Get API routes
  • Get zones
• Records
  • Get account records (v2)
  • Get map records
  • Get map records (v2)
  • Get record by ID
• Skins
  • Get equipped skins
  • Get favorited skins
  • Get skin info