Jump to Main ContentJump to Primary Navigation
News

Clash APIs

  • By Gene Chorba
  • Mar 26, 2020

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