---
title: "Get leaderboard (v2)"
method: GET
path: "/valorant/v2/leaderboard/{affinity}"
tags: ["valorant"]
---

# Get leaderboard (v2)

`GET /valorant/v2/leaderboard/{affinity}`

## Path parameters

- `affinity` string, required

## Query parameters

- `season` string
- `name` string
- `tag` string
- `puuid` string

## Response `200`

Leaderboard retrieved successfully

- LeaderboardV2Response
  - `immortal_1_threshold` integer, required
  - `immortal_2_threshold` integer, required
  - `immortal_3_threshold` integer, required
  - `last_update` integer, required
  - `next_update` integer, required
  - `players` LeaderboardPVPPlayer[], required
    - `IsAnonymized` boolean, required
    - `IsBanned` boolean, required
    - `PlayerCardID` string, required
    - `TitleID` string, required
    - `competitiveTier` integer, required
    - `gameName` string, required
    - `leaderboardRank` integer, required
    - `numberOfWins` integer, required
    - `puuid` string, nullable
    - `rankedRating` integer, required
    - `tagLine` string, required
  - `radiant_threshold` integer, required
  - `total_players` integer, required

## Other responses

- `400` — Bad Request
- `404` — Leaderboard not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/henrikdev/apis/henrikdev-api.md) · [All operations](https://skmtc.net/henrikdev/apis/henrikdev-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/henrikdev/henrikdev-api/versions/d0e83068dbeb/schema)