Riot Games · Schema

Riot Games Match

A League of Legends match record from the Riot Games Match v5 API

EsportsGamingLeague of LegendsLegends of RuneterraTeamfight TacticsVALORANT

Properties

Name Type Description
metadata object Match metadata
info object Match information
View JSON Schema on GitHub

JSON Schema

riot-games-match-schema.json Raw ↑
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://github.com/api-evangelist/riot-games/blob/main/json-schema/riot-games-match-schema.json",
  "title": "Riot Games Match",
  "description": "A League of Legends match record from the Riot Games Match v5 API",
  "type": "object",
  "properties": {
    "metadata": {
      "type": "object",
      "description": "Match metadata",
      "properties": {
        "dataVersion": {
          "type": "string",
          "description": "Match data version"
        },
        "matchId": {
          "type": "string",
          "description": "Match ID (e.g., NA1_4567890)"
        },
        "participants": {
          "type": "array",
          "description": "PUUIDs of all participants",
          "items": {
            "type": "string"
          }
        }
      },
      "required": ["matchId", "participants"]
    },
    "info": {
      "type": "object",
      "description": "Match information",
      "properties": {
        "gameCreation": {
          "type": "integer",
          "format": "int64",
          "description": "Unix timestamp when the game was created"
        },
        "gameDuration": {
          "type": "integer",
          "format": "int64",
          "description": "Game duration in seconds"
        },
        "gameId": {
          "type": "integer",
          "format": "int64"
        },
        "gameMode": {
          "type": "string",
          "description": "Game mode (e.g., CLASSIC, ARAM)",
          "example": "CLASSIC"
        },
        "gameName": {
          "type": "string"
        },
        "gameType": {
          "type": "string",
          "description": "Game type",
          "example": "MATCHED_GAME"
        },
        "gameVersion": {
          "type": "string",
          "description": "Patch version"
        },
        "mapId": {
          "type": "integer",
          "description": "Map ID"
        },
        "participants": {
          "type": "array",
          "description": "Participant data for all 10 players",
          "items": {
            "$ref": "#/definitions/Participant"
          }
        },
        "platformId": {
          "type": "string",
          "description": "Platform/region identifier",
          "example": "NA1"
        },
        "queueId": {
          "type": "integer",
          "description": "Queue type ID"
        }
      }
    }
  },
  "definitions": {
    "Participant": {
      "type": "object",
      "description": "A match participant's game data",
      "properties": {
        "puuid": {
          "type": "string"
        },
        "summonerName": {
          "type": "string"
        },
        "championId": {
          "type": "integer"
        },
        "championName": {
          "type": "string"
        },
        "kills": {
          "type": "integer",
          "minimum": 0
        },
        "deaths": {
          "type": "integer",
          "minimum": 0
        },
        "assists": {
          "type": "integer",
          "minimum": 0
        },
        "totalDamageDealt": {
          "type": "integer",
          "format": "int64"
        },
        "goldEarned": {
          "type": "integer"
        },
        "win": {
          "type": "boolean"
        },
        "teamId": {
          "type": "integer",
          "enum": [100, 200]
        },
        "teamPosition": {
          "type": "string",
          "enum": ["TOP", "JUNGLE", "MIDDLE", "BOTTOM", "UTILITY", ""]
        }
      }
    }
  },
  "required": ["metadata", "info"]
}