Skip to main content
GET
/
val
/
ranked
/
v1
/
leaderboards
/
by-act
/
{actId}
Get Leaderboard
curl --request GET \
  --url https://{region}.api.riotgames.com/val/ranked/v1/leaderboards/by-act/{actId}
{
  "response": {}
}

​
Method Signature

await client.GET_getLeaderboard(actId, region, size=200, startIndex=0)

​
Parameters

​
actId
string
required
The act ID to retrieve the leaderboard for
​
region
string
required
The region to execute against. Valid regions: ap, br, esports, eu, kr, latam, na
​
size
int
default:"200"
The amount of entries to retrieve. Valid values: 1 to 200
​
startIndex
int
default:"0"
The index to start from for pagination

​
Returns

​
response
Union[LeaderboardDto, Dict]
Returns a LeaderboardDto object containing the leaderboard data, or raw JSON dict if raw_data=True

​
Exceptions

  • InvalidRegion: If the provided region is invalid
  • ValueError: If the size is not between 1 and 200
  • 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 top 200 players for a specific act
    leaderboard = await client.GET_getLeaderboard(
        actId="52e9749a-41ae-4c84-8c88-b2b1f9e40d8c",
        region="na",
        size=200,
        startIndex=0
    )
    
    # Get next 200 players
    next_page = await client.GET_getLeaderboard(
        actId="52e9749a-41ae-4c84-8c88-b2b1f9e40d8c",
        region="na",
        size=200,
        startIndex=200
    )
    
    await client.close()

asyncio.run(main())
This method retrieves ranked leaderboard data for PC VALORANT. For console leaderboards, use GET_getConsoleLeaderboard.

Build docs developers (and LLMs) love

Get started for freeTalk to us