Connect to the League of Legends API to access game data. Test an API call in your browser and export the code snippet.
API for well-known game League Of Legends
Datatype | Description | Example |
---|---|---|
Datepicker | String which includes date and time | |
Map | String which includes latitude and longitude coma separated | |
List | Simple array | |
Select | String with predefined values | |
Array | Array of objects |
Get all champion mastery entries sorted by number of champion points descending
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
summonerId | Number | Summoner ID associated with the player |
Get a champion mastery by player ID and champion ID
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
summonerId | Number | Summoner ID associated with the player |
championId | Number | Champion ID to retrieve Champion Mastery for |
Get a player’s total champion mastery score, which is the sum of individual champion mastery levels.
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
summonerId | Number | Summoner ID associated with the player |
Retrieve all champions
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
Retrieve champion by ID
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
championId | Number | Id of the champion |
Get the challenger league for a given queue.
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
type | Select | Game queue type. Values: RANKED_FLEX_SR, RANKED_FLEX_TT, RANKED_SOLO_5x5 |
Get leagues in all queues for a given summoner ID
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
summonerId | Number | Id of the summoner |
Get the master league for a given queue.
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
type | Select | Game queue type. Values: RANKED_FLEX_SR, RANKED_FLEX_TT, RANKED_SOLO_5x5 |
Get league positions in all queues for a given summoner ID.
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
summonerId | Number | Id of the summoner |
Get League of Legends status for the given shard.
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
Get mastery pages for a given summoner ID.
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
summonerId | Number | Id of the summoner |
Get match IDs by tournament code
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
tournamentCode | String | Code of the tournament |
Get match by match ID.
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
matchId | Number | Id of the match |
Get match by match ID and tournament code
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
matchId | Number | Id of the match |
tournamentCode | String | Code of the tournament |
Get matchlist for ranked games played on given account ID and platform ID
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
accountId | Number | Id of the account |
queue | String | Set of queue IDs for which to filtering matchlist. |
beginTime | DatePicker | The begin time to use for filtering matchlist |
endIndex | Number | The end index to use for filtering matchlist. |
season | String | Set of season IDs for which to filtering matchlist. |
champion | String | Set of champion IDs for which to filtering matchlist. |
beginIndex | Number | The begin index to use for filtering matchlist. |
endTime | DatePicker | The end time to use for filtering matchlist |
Get matchlist for last 20 matches played on given account ID and platform ID
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
accountId | Number | Id of the account |
Get match timeline by match ID
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
matchId | Number | Id of the match |
Get rune pages for a given summoner ID
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
summonerId | Number | Id of the summoner |
Get current game information for the given summoner ID.
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
summonerId | Number | Id of the summoner |
Get list of featured games
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
Retrieves champion list
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
version | String | Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint |
champListData | List | Tags to return additional data. Only type, version, data, id, key, name, and title are returned by default if this parameter isn’t specified. To return all additional data, use the tag ‘all’. |
dataById | Boolean | If specified as true, the returned data map will use the champions’ IDs as the keys. If not specified or specified as false, the returned data map will use the champions’ keys instead. |
locale | String | Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used. |
Retrieves champion by ID
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
championId | Number | Id of the champion |
version | String | Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint |
locale | String | Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used. |
champData | List | Tags to return additional data. Only id, key, name, and title are returned by default if this parameter isn’t specified. To return all additional data, use the tag ‘all’. |
Retrieves item list
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
version | String | Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint |
locale | String | Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used. |
itemListData | List | Tags to return additional data. Only type, version, basic, data, id, name, plaintext, group, and description are returned by default if this parameter isn’t specified. To return all additional data, use the tag ‘all’. |
Retrieves item by ID
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
itemId | Number | Id of the item |
version | String | Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint |
locale | String | Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used. |
itemData | List | Tags to return additional data. Only id, name, plaintext, group, and description are returned by default if this parameter isn’t specified. To return all additional data, use the tag ‘all’. |
Retrieve language strings data
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
version | String | Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint |
locale | String | Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used. |
Retrieve supported languages data.
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
Retrieve map data.
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
version | String | Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint |
locale | String | Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used. |
Retrieves mastery list
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
version | String | Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint |
locale | String | Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used. |
masteryListData | List | Tags to return additional data. Only type, version, data, id, name, and description are returned by default if this parameter isn’t specified. To return all additional data, use the tag ‘all’. |
Retrieves mastery item by ID.
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
masteryId | Number | Id of the mastery |
version | String | Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint |
locale | String | Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used. |
masteryData | List | Tags to return additional data. Only type, version, data, id, name, and description are returned by default if this parameter isn’t specified. To return all additional data, use the tag ‘all’. |
Retrieve profile icons
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
version | String | Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint |
locale | String | Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used. |
Retrieve realm data
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
Retrieves runes list
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
version | String | Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint |
locale | String | Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used. |
runeListData | List | Tags to return additional data. Only type, version, data, id, name, rune, and description are returned by default if this parameter isn’t specified. To return all additional data, use the tag ‘all’. |
Retrieves rune by ID.
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
runeId | Number | Id of the rune |
version | String | Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint |
locale | String | Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used. |
runeData | List | Tags to return additional data. Only type, version, data, id, name, rune, and description are returned by default if this parameter isn’t specified. To return all additional data, use the tag ‘all’. |
Retrieves summoner spell list
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
version | String | Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint |
locale | String | Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used. |
spellListData | List | Tags to return additional data. Only type, version, data, id, key, name, description, and summonerLevel are returned by default if this parameter isn’t specified. To return all additional data, use the tag ‘all’. |
dataById | Boolean | If specified as true, the returned data map will use the spells’ IDs as the keys. If not specified or specified as false, the returned data map will use the spells’ keys instead. |
Retrieves summoner spell by id
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
summonerSpellId | Number | Id of the summoner spell |
version | String | Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint |
locale | String | Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used. |
spellData | List | Tags to return additional data. Only type, version, data, id, key, name, description, and summonerLevel are returned by default if this parameter isn’t specified. To return all additional data, use the tag ‘all’. |
Retrieve version data
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
Get a summoner by account ID.
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
accountId | Number | Id of the account |
Get a summoner by summoner name.
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
summonerName | String | Name of the summoner |
Get a summoner by summoner id.
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
summonerId | Number | Id of the summoner |
Gets a mock list of lobby events by tournament code
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
tournamentCode | String | Code of the tournament |
Returns the tournament code DTO associated with a tournament code string
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
tournamentCode | String | Code of the tournament |
Gets a list of lobby events by tournament code.
Field | Type | Description |
---|---|---|
apiKey | credentials | Api key obtained from Riot |
region | String | Region to execute against |
tournamentCode | String | Code of the tournament |