Public API Documentation

v1.2, revised August 8, 2017

#Introduction analyzes tens of millions of matches each month, resulting in highly correlated MMR values and robust distribution data. The WhatIsMyMMR public API makes it easier than ever to tap into this wealth of knowledge at no cost. This document outlines what’s possible with the API along with the ground rules. Let’s build something amazing!


Creative Commons Attribution 2.0 Generic (CC BY 2.0). You must provide attribution if you use this API.


Although the API is a free public resource, API consumers are expected to obey some basic rules to keep things running smoothly:


Endpoints are scoped by region and specified by the request subdomain. If no region is specified, na is used instead. For example,

naNorth America
euwEU West
euneEU Nordic & East


MMR is analyzed and tracked for the following queues:

rankedRanked 5v5 Draft Pick games
normalNormal 5v5 Draft Pick games


Returns the estimated ranked, normal, and ARAM MMRs for a summoner.


nameA case insensitive summoner’s name
<queue>.avgThe estimated MMR for the summoner in this queue. Is null if no estimate is available.
<queue>.errThe margin of error for the estimate using an 95% confidence interval for this queue.
<queue>.warnA boolean flag indicating if there was insufficient match data for this queue.
<queue>.timestampThe UTC timestamp of the last data processed for the summoner in this queue.
<queue>.historicalAn array of previous queue data objects with a minimum timescale of one day.
ranked.summaryHTML-formatted analysis of the summoner’s ranked standings based on MMR.
ranked.tierDataAn array of tier objects relative to the summoner’s current MMR, containing average, min, and max MMR.
ranked.historicalTierDataAn array of reduced tier objects relative to the summoner’s current MMR, containing the average MMR.


Returns a scaled number of players across the entire range of MMR for all queues.

To get the absolute number of players, divide a returned number by the summation of scaled numbers and multiply the result with the total number of players in the queue.


<queue>.<mmr>A scaled number of players at this MMR.