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 3 months ago

get

Get Leaderboard (latest version)

Authorizations

Path parameters

regionstring · enumrequired

Available options:

platformstring · enumrequired

Available options:

Query parameters

puuidstringoptional

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

namestringoptional

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

tagstringoptional

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

season_shortstring · enumoptional

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

Available options:

season_idstringoptional

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

sizeintegeroptional

Number of players returned

start_indexintegeroptional

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-03-31T17:47:26.380Z",
    "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-03-31T17:47:26.380Z"
      }
    ]
  }
}

Includes leaderboard data

Deprecated

get

Get Leaderboard

Authorizations

Path parameters

regionstring · enumrequired

Available options:

Query parameters

puuidstringoptional

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

namestringoptional

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

tagstringoptional

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

seasonstring · enumoptional

Returns the leaderboard for a specific season

Available options:

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