Leaderboard

Returns the current leaderboard for the requested region

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

Deprecated

get

Get Leaderboard

Authorizations

Path parameters

regionstring · enumRequiredPossible values:

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

Possible values:

Responses

200

Leaderboard Data

application/json

400

Request error by the client (missing query for example)

application/json

408

Timeout while fetching riot data

application/json

429

Rate limit reached (can be global API limit which affects all users or just you, when the "x-ratelimit-remaining" header is 0 then it's a personal limit)

application/json

500

Internal Error (error is logged, will be reviewed asap)

application/json

get

HTTPcURLJavaScriptPython

GET /valorant/v1/leaderboard/{region} HTTP/1.1
Host: api.henrikdev.xyz
Authorization: YOUR_API_KEY
Accept: */*

[
  {
    "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
  }
]

get

Get Leaderboard (latest version)

Authorizations

Path parameters

regionstring · enumRequiredPossible values:

platformstring · enumRequiredPossible values:

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)

Possible values:

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

200

Includes leaderboard data

application/json

400

Request error by the client (missing query for example)

application/json

408

Timeout while fetching riot data

application/json

429

Rate limit reached (can be global API limit which affects all users or just you, when the "x-ratelimit-remaining" header is 0 then it's a personal limit)

application/json

500

Internal Error (error is logged, will be reviewed asap)

application/json

get

HTTPcURLJavaScriptPython

GET /valorant/v3/leaderboard/{region}/{platform} HTTP/1.1
Host: api.henrikdev.xyz
Authorization: YOUR_API_KEY
Accept: */*

{
  "status": 1,
  "data": {
    "updated_at": "2025-05-12T02:27:31.139Z",
    "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-05-12T02:27:31.139Z"
      }
    ]
  }
}