Leaderboard

Returns the current leaderboard for the requested region

v1 is deprecated. Please switch to v3 to be on the latest version

PreviousEsports NextMatchlist

Last updated 2 months ago

Deprecated

Get Leaderboard

get

/valorant/v1/leaderboard/{region}

Authorizations

Path parameters

regionstring · enumrequired

Options: eu, na, latam, br, ap, kr

Query parameters

puuidstring

Note that you can only filter by puuid or name and tag, both at the same time is logically not possible

namestring

Note that you can only filter by puuid or name and tag, both at the same time is logically not possible

tagstring

Note that you can only filter by puuid or name and tag, both at the same time is logically not possible

seasonstring · enum

Returns the leaderboard for a specific season

Options: e1a1, e1a2, e1a3, e2a1, e2a2, e2a3, e3a1, e3a2, e3a3, e4a1, e4a2, e4a3, e5a1, e5a2, e5a3, e6a1, e6a2, e6a3, e7a1, e7a2, e7a3, e8a1, e8a2, e8a3, e9a1, e9a2, e9a3

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.henrikdev.xyz/valorant/v1/leaderboard/{region}' \
  --header 'Authorization: YOUR_API_KEY'

200

400

408

429

500

[
  {
    "PlayerCardID": "8edf22c5-4489-ab41-769a-07adb4c454d6",
    "TitleID": "82de085a-4c2b-da95-a139-048e4ce83dae",
    "IsBanned": false,
    "IsAnonymized": false,
    "puuid": "c3b5b276-a43d-53f2-a897-038bc60b6682",
    "gameName": "Liquid ScreaM",
    "tagLine": "1TAP",
    "leaderboardRank": 1,
    "rankedRating": 1222,
    "numberOfWins": 67,
    "competitiveTier": 24
  }
]

Leaderboard Data

Get Leaderboard (latest version)

get

/valorant/v3/leaderboard/{region}//{platform}

Authorizations

Path parameters

regionstring · enumrequired

Options: eu, na, latam, br, ap, kr

platformstring · enumrequired

Options: pc, console

Query parameters

puuidstring

Note that you can only filter by puuid or name and tag, both at the same time is logically not possible

namestring

Note that you can only filter by puuid or name and tag, both at the same time is logically not possible

tagstring

Note that you can only filter by puuid or name and tag, both at the same time is logically not possible

season_shortstring · enum

Returns the leaderboard for a specific season by short season (cannot be used in combination mit season_id)

season_idstring

Returns the leaderboard for a specific season by it's real id (cannot be used in combination mit season_short)

Example: 4539cac3-47ae-90e5-3d01-b3812ca3274e

sizeinteger

Number of players returned

start_indexinteger

Pagination starting point

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.henrikdev.xyz/valorant/v3/leaderboard/{region}/{platform}' \
  --header 'Authorization: YOUR_API_KEY'

200

400

408

429

500

{
  "status": 1,
  "data": {
    "updated_at": "2025-02-22T10:35:38.016Z",
    "thresholds": [
      {
        "tier": 1,
        "start_index": 1,
        "threshold": 1
      }
    ],
    "players": [
      {
        "card": "text",
        "title": "text",
        "is_banned": true,
        "is_anonymized": true,
        "puuid": "text",
        "name": "text",
        "tag": "text",
        "leaderboard_rank": 1,
        "tier": 1,
        "rr": 1,
        "wins": 1,
        "updated_at": "2025-02-22T10:35:38.016Z"
      }
    ]
  }
}

Includes leaderboard data