Attention: This change log reflects changes that are made to the Riot Games API endpoints and infrastructure. To view changes to the Developer Portal website, visit the Developer Portal Change Log.


October 16th, 2018

  • [announcement] The old champion-v3 free champion rotation endpoints have been deprecated in favor of new replacement endpoints.


August 27th, 2018

  • [announcement] The lol-static-data-v3 API has been deprecated leaving Data Dragon as the sole source of truth for static data.


July 6th, 2018

  • We've included the tournament-stub-v3 API as part of the Standard APIs that everyone has access to with their development API key.

    The tournament-stub-v3 API is a stand in that simulates the behavior of the tournament-v3 API. Developers looking to apply for tournament-v3 API access should use the stub to mock their implementation before applying for a production key.

    We're starting the method rate limits off relatively low, but they should be more than enough for mock ups. You can view the rate limits for the tournament stub in the Rate Limiting documentation.


May 31st, 2018

  • The persistence for third-party-code-v3 has been updated. This change shouldn't result in any change to this endpoint's behavior except for the following limitations for codes:
    • Codes are limited to 256 characters
    • Valid characters include 0-9, a-z, A-Z, and -


April 30th, 2018


February 22nd, 2018

  • [announcement] New endpoints were added to lol-static-data-v3 for runes reforged data and the dragon tail tarball.


January 16th, 2018

  • The POST_createTournamentCode and PUT_updateCode endpoints have been updated to have a consistent POST/PUT body. These endpoints remain backward compatible with the body originally accepted by the service.


January 10, 2018

  • The GET_getAllLeaguesForSummoner endpoint has been deprecated.


January 4, 2018

  • The bug in the GET_getLeagueById endpoint where losses were returned as 0 for all participants has now been fixed.


August 30, 2017

  • The bug in the GET_getAllLeaguesForSummoner endpoint where losses were incorrectly returned 0 for participants other than the queried summoner has now been fixed.


August 29, 2017

  • The /lol/match/v3/matchlists/by-account/{accountId} endpoint is now clamped to a max index range of 100 games instead of 50 now, which is also the default range if you don't specify any index parameters.
  • The optional forAccountId and forPlatformId parameters on the /lol/match/v3/matches/{matchId} endpoint are now obsolete so they have been removed (it won't hurt if you still pass them, but they are ignored).


August 24, 2017

  • Changes to match history system are now live, meaning that the match-v3 APIs, the LCU, and the match history website are all now de-anonymized.
  • An announcement will follow when we decide if/how this will affect the public API offerings.
  • The /lol/match/v3/matchlists/by-account/{accountId} endpoint is now clamped to a max index range of 50 games, which is also the default range if you don't specify any index parameters.
  • We have made some related updates to the documentation of the parameters for the match list endpoint.
  • There are now service and method rate limits in place for all leagues endpoints in all regions. The method rate limits for these endpoints have been added to the rate limiting documentation.


August 15, 2017

  • There are stricter method rate limits in place for static data.
  • You will be required to respect method and service rate limits going forward to avoid blacklisting.
  • There is a known bug in the /lol/league/v3/leagues/by-summoner/{summonerId} endpoint with losses being incorrectly returned as 0.
  • See this announcement for more information.


August 10, 2017

  • The issue with the summoner API returning 404s for valid summoner names that contained special characters (particularly noticed for TR) is now fixed.
  • The Date header is now included in all responses.


August 9, 2017

  • We have stabilized the platform data service (runes, masteries, champions endpoints). As part of this effort, service and method rate limits have now been applied to this service. The method rate limits for these endpoints have been added to the rate limiting documentation.


August 2, 2017


July 27, 2017


July 24, 2017

  • Deprecation of all v1 and v2 endpoints is complete. Only the v3 endpoints remain.


July 19, 2017

  • We now have a solution for the participant mirror match issue in match details. When you query the match details via /lol/match/v3/matches/{matchId}, you can now specify an optional query parameter 'forAccountId'. If specified, the participant that maps to the given accountId will be non-obfuscated. For example, the following returns the unobfuscated participant details for the specified account ID.


July 11, 2017

  • All API responses now include the X-App-Rate-Limit and X-Method-Rate-Limit headers that show the API key rate limit and method endpoint rate limits that are applied to calls for your API key. Please see the Rate Limiting documentation for more information.


July 11, 2017

  • SEASON 2017 games now properly show up marked with season ID 9 in the following endpoints:
    • /api/lol/{region}/v2.2/match/{matchId}
    • /api/lol/{region}/v2.2/matchlist/by-summoner/{summonerId}
    • /lol/match/v3/matches/{matchId}
    • /lol/match/v3/timelines/by-match/{matchId}
    • /lol/match/v3/matchlists/by-account/{accountId}
    • /lol/match/v3/matchlists/by-account/{accountId}/recent


July 10, 2017

  • Filtering by season now works for all seasons for the following endpoints.
    • api/lol/{region}/v2.2/matchlist/by-summoner/{summonerId}
    • /lol/match/v3/matchlists/by-account/{accountId}
  • Method rate limits have been added for the following endpoints.
    • 500 requests / 10 sec
      • /api/lol/{region}/v2.2/match/{matchId}
      • /lol/match/v3/matches/{matchId}
      • /lol/match/v3/timelines/by-match/{matchId}
    • 1000 requests / 10 sec
      • /api/lol/{region}/v2.2/matchlist/by-summoner/{summonerId}
      • /lol/match/v3/matchlists/by-account/{accountId}
      • /lol/match/v3/matchlists/by-account/{accountId}/recent


July 7, 2017

  • The following endpoints now include the summoner and account information for participants.
    • /lol/match/v3/matches/{matchId}/by-tournament-code/{tournamentCode}
    • /api/lol/{region}/v2.2/match/for-tournament/{matchId}


July 5th, 2017

  • Development API keys now expire after 24 hours. You can regenerate your API key any time, but the expiry will only refresh if you're within 1 hour of the date.
  • Because development API keys will be temporary the rate limit for these keys has been raised to 20 calls every second and 100 calls every 2 minutes.
  • More information is available here.


June 8, 2017


June 1, 2017


May 8, 2017

  • Updates to API to validate request parameters and improve error messaging for invalid requests.
  • Parameters for V3 endpoints that allow multiple values are now being enforced as sets (e.g., season=0&season=1), rather than comma-delimited strings (e.g., season=0,1).


May 1, 2017

  • league-v3
    • The old leagues v2.5 API will be included in the 90 day deprecation window that ends Monday July 24th.


April 24, 2017

  • match-v3
    • See the V3 API thread for details on the new match-v3 endpoints.
  • 90 day deprecation period has started for v1/v2 endpoints.


April 20, 2017


April 7, 2017

  • lol-status-v3
    • We're releasing lol-status-v3 with only one of the previous endpoints. The v1/shard was converted to v3/shard-data, and we're dropping the v1/shards endpoint which contained no additional information that wasn't already being returned by the v1/shard endpoint.


April 6, 2017

  • champion-v3
  • static-data-v3
  • runes-v3
  • masteries-v3
  • tournament-v3
  • tournament-stub-v3


April 5, 2017

  • champion-mastery-v3


April 4, 2017

  • Riot Games API V3 has been announced. There are a lot of changes, so please refer to the announcement for the most up-to-date information:
  • summoner-v3
  • spectator-v3


March 22, 2017

  • We've officially started supporting a new domain for the Riot Games API:
    https://{regional endpoint}

    Please refer to the Regional Endpoints documentation. More information on this to come.


March 15, 2017

  • We've released new rate limit headers X-App-Rate-Limit-Count and X-Method-Rate-Limit-Count to replace X-Rate-Limit-Count, which will be deprecated. Please refer to the Rate Limiting documentation for more information.