Hey Folks,
Welcome to the Clash API. With the launch of Clash, we are adding endpoints for Clash to any active key with access to the League of Legends APIs. However, as always, if you are building a new feature for release, it must be reviewed by the DevRel team. To complete this review, reach out to us through an App Message on developer.riotgames.com. Again, this must be completed prior to making the feature or product available to players.
Clash endpoints
Player Lookup
getPlayersBySummoner
/lol/clash/v1/players/by-summoner/{summonerId}
When Clash is inactive, getPlayersBySummoner will return an empty list of Clash players.
Team Lookup
getTeamById
/lol/clash/v1/teams/{teamId}
Tournament Lookup
getTournaments
/lol/clash/v1/tournaments
Returns a list of active and upcoming tournaments.
getTournamentByTeam
/lol/clash/v1/tournaments/by-team/{teamId}
getTournamentById
/lol/clash/v1/tournaments/{tournamentId}
With a Clash tournament starting up this weekend, we encourage you to check out the new Clash API and ask any questions you might have in Friday’s office hours on Discord. If you encounter any issues with the new Clash endpoints, please submit a GitHub issue. If you have questions about how your products can leverage these endpoints, be sure to reach out to the team through the Developer Portal.
Sample Responses
https://na1.api.riotgames.com/lol/clash/v1/players/by-summoner/_uBkLn2z2_rX3MKI9CKs1mqmQDec_atrMvVoeUJnCAY_4Po?api_key=
[
{
"summonerId": "_uBkLn2z2_rX3MKI9CKs1mqmQDec_atrMvVoeUJnCAY_4Po",
"teamId": "00000000-0000-0000-0000-000000000000",
"position": "FILL",
"role": "CAPTAIN"
},
...
]
https://na1.api.riotgames.com/lol/clash/v1/teams/00000000-0000-0000-0000-000000000000?api_key=
{
"id": "00000000-0000-0000-0000-000000000000",
"tournamentId": 0,
"name": "",
"iconId": 0,
"tier": 2,
"captain": "_uBkLn2z2_rX3MKI9CKs1mqmQDec_atrMvVoeUJnCAY_4Po",
"abbreviation": "",
"players": [
{
"summonerId": "_uBkLn2z2_rX3MKI9CKs1mqmQDec_atrMvVoeUJnCAY_4Po",
"position": "FILL",
"role": "CAPTAIN"
},
...
]
}
https://na1.api.riotgames.com/lol/clash/v1/tournaments?api_key=
[
{
"id": 0,
"themeId": 0,
"nameKey": "freljord",
"nameKeySecondary": "day_1",
"schedule": [
{
"id": 0,
"registrationTime": 0,
"startTime": 0,
"cancelled": false
},
...
]
},
...
]
https://na1.api.riotgames.com/lol/clash/v1/tournaments/0?api_key=
{
"id": 0,
"themeId": 0,
"nameKey": "freljord",
"nameKeySecondary": "day_1",
"schedule": [
{
"id": 0,
"registrationTime": 0,
"startTime": 0,
"cancelled": false
},
...
]
}
https://na1.api.riotgames.com/lol/clash/v1/tournaments/by-team/00000000-0000-0000-0000-000000000000?api_key=
{
"id": 0,
"themeId": 0,
"nameKey": "freljord",
"nameKeySecondary": "day_1",
"schedule": [
{
"id": 0,
"registrationTime": 0,
"startTime": 0,
"cancelled": false
},
...
]
}
We look forward to seeing what you develop soon,
Gene
