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

​
Method Signature

await client.GET_getConsoleMatchlist(puuid, region, platformType)

​
Parameters

​
puuid
string
required
The player’s PUUID (Player Universally Unique Identifier)
​
region
string
required
The region to execute against. Valid regions: ap, br, esports, eu, kr, latam, na
​
platformType
string
required
The platform type to retrieve matchlist for. Valid values:
  • playstation - PlayStation console
  • xbox - Xbox console

​
Returns

​
response
Union[MatchlistDto, Dict]
Returns a MatchlistDto object containing a list of match IDs, or raw JSON dict if raw_data=True

​
Exceptions

  • InvalidRegion: If the provided region is invalid
  • InvalidPlatformType: If the provided platform type is invalid (must be “playstation” or “xbox”)
  • 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 PlayStation matchlist for a player
    matchlist = await client.GET_getConsoleMatchlist(
        puuid="abc123-def456-ghi789-jkl012",
        region="na",
        platformType="playstation"
    )
    
    # Get Xbox matchlist for the same player
    xbox_matchlist = await client.GET_getConsoleMatchlist(
        puuid="abc123-def456-ghi789-jkl012",
        region="na",
        platformType="xbox"
    )
    
    # Iterate through match IDs
    for match_id in matchlist.history:
        print(f"Match ID: {match_id}")
    
    await client.close()

asyncio.run(main())
This endpoint returns match history for console VALORANT only. Platform types are case-insensitive but must be either “playstation” or “xbox”.

Build docs developers (and LLMs) love

Get started for freeTalk to us