Riot Games · JSON Structure

Riot Games Match Structure

Structure of a League of Legends match record from the Match v5 API

Type: Properties: 0
EsportsGamingLeague of LegendsLegends of RuneterraTeamfight TacticsVALORANT

Riot Games Match is a JSON Structure definition published by Riot Games.

Meta-schema:

JSON Structure

Raw ↑
{
  "name": "Riot Games Match",
  "description": "Structure of a League of Legends match record from the Match v5 API",
  "fields": [
    {
      "name": "metadata",
      "type": "object",
      "description": "Match metadata",
      "fields": [
        {"name": "dataVersion", "type": "string", "description": "Data version"},
        {"name": "matchId", "type": "string", "description": "Unique match ID (e.g., NA1_4567890)", "required": true},
        {"name": "participants", "type": "array", "items": "string", "description": "PUUIDs of all 10 participants"}
      ]
    },
    {
      "name": "info",
      "type": "object",
      "description": "Match information and participant data",
      "fields": [
        {"name": "gameCreation", "type": "integer", "description": "Unix ms timestamp when game was created"},
        {"name": "gameDuration", "type": "integer", "description": "Duration in seconds"},
        {"name": "gameId", "type": "integer", "description": "Numeric game ID"},
        {"name": "gameMode", "type": "string", "description": "Game mode (CLASSIC, ARAM, etc.)"},
        {"name": "gameName", "type": "string"},
        {"name": "gameType", "type": "string", "description": "MATCHED_GAME or CUSTOM_GAME"},
        {"name": "gameVersion", "type": "string", "description": "Patch version"},
        {"name": "mapId", "type": "integer", "description": "Map identifier"},
        {"name": "platformId", "type": "string", "description": "Region (NA1, EUW1, etc.)"},
        {"name": "queueId", "type": "integer", "description": "Queue type ID"},
        {
          "name": "participants",
          "type": "array",
          "description": "All 10 player records",
          "items": {
            "type": "object",
            "fields": [
              {"name": "puuid", "type": "string"},
              {"name": "summonerName", "type": "string"},
              {"name": "championId", "type": "integer"},
              {"name": "championName", "type": "string"},
              {"name": "kills", "type": "integer"},
              {"name": "deaths", "type": "integer"},
              {"name": "assists", "type": "integer"},
              {"name": "totalDamageDealt", "type": "integer"},
              {"name": "goldEarned", "type": "integer"},
              {"name": "win", "type": "boolean"},
              {"name": "teamId", "type": "integer", "description": "100 (blue) or 200 (red)"},
              {"name": "teamPosition", "type": "string", "description": "TOP, JUNGLE, MIDDLE, BOTTOM, UTILITY"}
            ]
          }
        }
      ]
    }
  ]
}