Get player matchmaking status

GET https://meet.trackmania.nadeo.club/api/matchmaking/{matchmakingType}/player-status

Headers:


Path parameters:

  • {matchmakingType} integer The ID of the matchmaking type *

Gets the matchmaking status of the currently authenticated user.


Remarks:

  • See the glossary for a list of available matchmaking types and their IDs.
  • This endpoint is only useful with tokens authenticated through Ubisoft user accounts (as opposed to dedicated server accounts).
  • The response field "currentHeartbeat" will be an object with the same data received as when sending a heartbeat request.

Example request:

https://meet.trackmania.nadeo.club/api/matchmaking/5/player-status

Example response:

{
  "currentHeartbeat": null,
  "penalty": null,
  "currentDivision": "8afc1512-6acf-4495-92db-f4dc92c36926",
  "currentProgression": 3703,
  "matchmakingStatus": "enabled",
  "inactivity": {
    "inactivityPenaltyEnabled": true,
    "immunityDays": 10,
    "penalty": -20
  },
  "matchGenerationTimer": null
}