Skip to main content
GET
/
val
/
match
/
console
/
v1
/
matches
/
{matchId}
Get Console Match
curl --request GET \
  --url https://{region}.api.riotgames.com/val/match/console/v1/matches/{matchId}
{
  "response": {}
}

​
Method Signature

await client.GET_getConsoleMatch(matchId, region)

​
Parameters

​
matchId
string
required
The match ID to retrieve data for
​
region
string
required
The region to execute against. Valid regions: ap, br, esports, eu, kr, latam, na

​
Returns

​
response
Union[MatchDto, Dict]
Returns a MatchDto object containing detailed match data, or raw JSON dict if raw_data=True

​
Exceptions

  • InvalidRegion: If the provided region is invalid
  • RiotAPIResponseError: If the API response indicates an error

​
Example

import asyncio
from valaw import Client

async def main():
    client = Client(token="YOUR_API_KEY", cluster="americas")
    
    # Get console match details
    match = await client.GET_getConsoleMatch(
        matchId="abc123-def456-ghi789",
        region="na"
    )
    
    # Access match data
    print(f"Match ID: {match.matchInfo.matchId}")
    print(f"Map: {match.matchInfo.mapId}")
    print(f"Game Mode: {match.matchInfo.queueId}")
    
    await client.close()

asyncio.run(main())
This endpoint retrieves match data specifically for console VALORANT matches (PlayStation and Xbox). For PC matches, use GET_getMatch.

Build docs developers (and LLMs) love

Get started for freeTalk to us