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

​
Method Signature

await client.GET_getConsoleRecent(queue, region)

​
Parameters

​
queue
string
required
The queue to retrieve recent matches for. Valid console queues:
  • console_unrated - Unrated matches
  • console_swiftplay - Swift Play matches
  • console_hurm - Team Deathmatch
  • console_competitive - Competitive/Ranked matches
  • console_deathmatch - Deathmatch
​
region
string
required
The region to execute against. Valid regions: ap, br, esports, eu, kr, latam, na

​
Returns

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

​
Exceptions

  • InvalidRegion: If the provided region is invalid
  • InvalidQueue: If the provided queue is not a valid console queue
  • RiotAPIResponseError: If the API response indicates an error

​
Response Details

Returns a list of match IDs that have completed:
  • Live regions: Matches from the last 10 minutes
  • Esports routing: Matches from the last 12 hours
NA/LATAM/BR share a match history deployment. Recent matches will return a combined list of matches from those three regions. Requests are load balanced, so you may see some inconsistencies as matches are added/removed from the list.

​
Example

import asyncio
from valaw import Client

async def main():
    client = Client(token="YOUR_API_KEY", cluster="americas")
    
    # Get recent competitive console matches
    recent = await client.GET_getConsoleRecent(
        queue="console_competitive",
        region="na"
    )
    
    # Get recent unrated console matches
    unrated_recent = await client.GET_getConsoleRecent(
        queue="console_unrated",
        region="eu"
    )
    
    # Process recent match IDs
    for match_id in recent.matchIds:
        print(f"Recent match: {match_id}")
    
    await client.close()

asyncio.run(main())
Console queues are prefixed with console_ to distinguish them from PC queues. For PC recent matches, use GET_getRecent.

Build docs developers (and LLMs) love

Get started for freeTalk to us