Using the league-v4 Endpoint to get the ranks of a summoner

The summoner-v4 API in League of Legends is used to get ranking informations about a player or a league.

The base url is https://{platform}
Please make sure to replace {platform} with your current platform.

By Summoner

Using this method you can get the rank(s) of a player using their encrypted summoner id which you can get with summoner-v4.


The result is an array of queueTypes. If the player is not ranked in the queueType or hasn't finished their placement games the queueType won't appear in the result. That can lead to an empty [] result, especially after a rank reset.

  "miniSeries": {
    "target": 3,
    "wins": 2,
    "losses": 2,
    "progress": "LWLWN"
}, {


The fields can apply multiple times, as the result is an array of LeagueEntryDTOs[]


Field Type Note
leagueId String (leagueId) The ID of the league the summoner currently is in.
queueType String (ENUM) RANKED_SOLO_5x5 or RANKED_FLEX_SR
tier String (ENUM) From IRON to CHALLENGER. The current tier of the summoner.
rank String (ENUM) FROM I (1) to IV (4). Apex-tiers (MASTER+) are always rank I.
summonerId String Also called "encrypted summoner id". Id is unique per platform and used to identify the player in this response.
summonerName String Name of the summoner.
leaguePoints Number The current LP of the summoner.
wins Number Number of wins of the summoner during the ranked season in the queueType.
losses Number Number of losses of the summoner during the ranked season in the queueType.
veteran Boolean The summoner has played more than 100 games in the division.
inactive Boolean The summoner isn't playing actively. This field is true if the player will decay in high-elo.
freshBlood Boolean The summoner is new to the division.
hotStreak Boolean Winning streak of 3 or higher.
miniSeries miniSeriesDTO Only set if a mini series is given. Mini series are the promotion series of a summoner.


Keep in mind that the mini series is only set if a summoner is in his promos.

Field Type Note
target Number How many wins are needed to successfully complete the promos.
wins Number The wins of a summoner during the promotion series.
losses Number The losses of a summoner during the promotion series.
progress String The progress as a string. In which order a player won/lost games. W=WIN, L=LOSS, N=NOT-PLAYED

Understanding the response

A short explanation of the current response (JSON snippet above) into "words":

The summoner 'name' is BRONZE 2 in ranked solo/duo with 100LP and a 20% winrate. The summoner is currently 2w/2l in his promotions and won his last game.

Frequently Asked Questions

Is it possible to get historical ranks of a sumoner?

No, that's not possible. If you want to know how much LP a summoner got during a game, you need to track the summoners LP before and after the game.

Using the league-v4 Endpoint to get the ranks of a summoner

©2020 - 2024