MMR

v1 is deprecated. Please switch to v3 to be on the latest version

Get a more detailed response for all MMR data

get

Get mmr details

Authorizations

Path parameters

namestringRequired

tagstringRequired

regionstring · enumRequired

Choose from ap, br, eu, kr, latam, na (br and latam will be internally converted to na)

Possible values:

Query parameters

seasonstring · enumOptional

Available for v2 mmr only

Possible values:

Responses

200

MMR Details

application/json

400

Request error by the client (missing query for example)

application/json

403

Forbidden to connect to the Riot API (mainly maintenance reasons on riot side like patches) or to the HenrikDev API itself because of bot prevention for example

application/json

404

The entity was not found (player/match/general data)

application/json

408

Timeout while fetching riot data

application/json

410

Endpoint is deprecated

application/json

429

Rate limit reached (can be global API limit which affects all users or just you, when the "x-ratelimit-remaining" header is 0 then it's a personal limit)

application/json

501

API Version not implemented, check the requested endpoint url

application/json

503

Riot API seems to be down, API unable to connect

application/json

get

HTTPcURLJavaScriptPython

GET /valorant/v2/mmr/{region}/{name}/{tag} HTTP/1.1
Host: api.henrikdev.xyz
Authorization: YOUR_API_KEY
Accept: */*

{
  "status": 200,
  "data": {
    "name": "Henrik3",
    "tag": "EUW3",
    "current_data": {
      "currenttier": 12,
      "currenttier_patched": "Gold 1",
      "images": {
        "small": "text",
        "large": "text",
        "triangle_down": "text",
        "triangle_up": "text"
      },
      "ranking_in_tier": 20,
      "mmr_change_to_last_game": -16,
      "elo": 920,
      "old": true
    },
    "highest_rank": {
      "old": false,
      "tier": 19,
      "patched_tier": "Diamond 2",
      "season": "e5a3"
    },
    "by_season": {
      "e6a3": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e6a2": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e6a1": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e5a3": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e5a2": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e5a1": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e4a3": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e4a2": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e4a1": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e3a3": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e3a2": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e3a1": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e2a3": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e2a2": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e2a1": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e1a3": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e1a2": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e1a1": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      }
    }
  }
}

get

Get MMR details, leaderboard placement and more

Authorizations

Path parameters

regionstring · enumRequired

Choose from ap, br, eu, kr, latam, na (br and latam will be internally converted to na)

Possible values:

namestringRequired

Name of the user

tagstringRequired

Tag of the user

platformstring · enumRequired

Platform (console/pc)

Possible values:

Responses

200

MMR response

application/json

400

Request error by the client (missing query for example)

application/json

403

Forbidden to connect to the Riot API (mainly maintenance reasons on riot side like patches) or to the HenrikDev API itself because of bot prevention for example

application/json

404

The entity was not found (player/match/general data)

application/json

408

Timeout while fetching riot data

application/json

410

Endpoint is deprecated

application/json

429

Rate limit reached (can be global API limit which affects all users or just you, when the "x-ratelimit-remaining" header is 0 then it's a personal limit)

application/json

501

API Version not implemented, check the requested endpoint url

application/json

503

Riot API seems to be down, API unable to connect

application/json

get

HTTPcURLJavaScriptPython

GET /valorant/v3/mmr/{region}/{platform}/{name}/{tag} HTTP/1.1
Host: api.henrikdev.xyz
Authorization: YOUR_API_KEY
Accept: */*

{
  "status": 200,
  "data": {
    "account": {
      "puuid": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Henrik3",
      "tag": "VALO"
    },
    "peak": {
      "season": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "short": "e1a1"
      },
      "ranking_schema": "ascendant",
      "tier": {
        "id": 1,
        "name": "Unrated"
      }
    },
    "current": {
      "tier": {
        "id": 1,
        "name": "Unrated"
      },
      "rr": 1,
      "last_change": 1,
      "elo": 1,
      "games_needed_for_rating": 1,
      "leaderboard_placement": {
        "rank": 1,
        "updated_at": "2025-06-01T07:52:38.210Z"
      }
    },
    "seasonal": [
      {
        "season": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "short": "e1a1"
        },
        "wins": 1,
        "games": 1,
        "end_tier": {
          "id": 1,
          "name": "Unrated"
        },
        "ranking_schema": "ascendant",
        "leaderboard_placement": {
          "rank": 1,
          "updated_at": "2025-06-01T07:52:38.210Z"
        },
        "act_wins": [
          {
            "id": 1,
            "name": "Unrated"
          }
        ]
      }
    ]
  }
}

get

Get MMR Details

Authorizations

Path parameters

regionstring · enumRequired

Choose from ap, br, eu, kr, latam, na (br and latam will be internally converted to na)

Possible values:

puuidstringRequired

PUUID of the user

Query parameters

seasonstring · enumOptional

Available for v2 MMR

Possible values:

Responses

200

MMR Details

application/json

400

Request error by the client (missing query for example)

application/json

403

Forbidden to connect to the Riot API (mainly maintenance reasons on riot side like patches) or to the HenrikDev API itself because of bot prevention for example

application/json

404

The entity was not found (player/match/general data)

application/json

408

Timeout while fetching riot data

application/json

410

Endpoint is deprecated

application/json

429

Rate limit reached (can be global API limit which affects all users or just you, when the "x-ratelimit-remaining" header is 0 then it's a personal limit)

application/json

501

API Version not implemented, check the requested endpoint url

application/json

503

Riot API seems to be down, API unable to connect

application/json

get

HTTPcURLJavaScriptPython

GET /valorant/v2/by-puuid/mmr/{region}/{puuid} HTTP/1.1
Host: api.henrikdev.xyz
Authorization: YOUR_API_KEY
Accept: */*

{
  "status": 200,
  "data": {
    "name": "Henrik3",
    "tag": "EUW3",
    "current_data": {
      "currenttier": 12,
      "currenttier_patched": "Gold 1",
      "images": {
        "small": "text",
        "large": "text",
        "triangle_down": "text",
        "triangle_up": "text"
      },
      "ranking_in_tier": 20,
      "mmr_change_to_last_game": -16,
      "elo": 920,
      "old": true
    },
    "highest_rank": {
      "old": false,
      "tier": 19,
      "patched_tier": "Diamond 2",
      "season": "e5a3"
    },
    "by_season": {
      "e6a3": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e6a2": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e6a1": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e5a3": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e5a2": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e5a1": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e4a3": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e4a2": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e4a1": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e3a3": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e3a2": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e3a1": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e2a3": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e2a2": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e2a1": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e1a3": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e1a2": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      },
      "e1a1": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ],
        "old": true
      }
    }
  }
}

get

Get MMR details, leaderboard placement and more

Authorizations

Path parameters

regionstring · enumRequired

Choose from ap, br, eu, kr, latam, na (br and latam will be internally converted to na)

Possible values:

puuidstringRequired

PUUID of the user

platformstring · enumRequired

Platform (console/pc)

Possible values:

Responses

200

MMR response

application/json

400

Request error by the client (missing query for example)

application/json

403

Forbidden to connect to the Riot API (mainly maintenance reasons on riot side like patches) or to the HenrikDev API itself because of bot prevention for example

application/json

404

The entity was not found (player/match/general data)

application/json

408

Timeout while fetching riot data

application/json

410

Endpoint is deprecated

application/json

429

Rate limit reached (can be global API limit which affects all users or just you, when the "x-ratelimit-remaining" header is 0 then it's a personal limit)

application/json

501

API Version not implemented, check the requested endpoint url

application/json

503

Riot API seems to be down, API unable to connect

application/json

get

HTTPcURLJavaScriptPython

GET /valorant/v3/by-puuid/mmr/{region}/{platform}/{puuid} HTTP/1.1
Host: api.henrikdev.xyz
Authorization: YOUR_API_KEY
Accept: */*

{
  "status": 200,
  "data": {
    "account": {
      "puuid": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Henrik3",
      "tag": "VALO"
    },
    "peak": {
      "season": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "short": "e1a1"
      },
      "ranking_schema": "ascendant",
      "tier": {
        "id": 1,
        "name": "Unrated"
      }
    },
    "current": {
      "tier": {
        "id": 1,
        "name": "Unrated"
      },
      "rr": 1,
      "last_change": 1,
      "elo": 1,
      "games_needed_for_rating": 1,
      "leaderboard_placement": {
        "rank": 1,
        "updated_at": "2025-06-01T07:52:38.210Z"
      }
    },
    "seasonal": [
      {
        "season": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "short": "e1a1"
        },
        "wins": 1,
        "games": 1,
        "end_tier": {
          "id": 1,
          "name": "Unrated"
        },
        "ranking_schema": "ascendant",
        "leaderboard_placement": {
          "rank": 1,
          "updated_at": "2025-06-01T07:52:38.210Z"
        },
        "act_wins": [
          {
            "id": 1,
            "name": "Unrated"
          }
        ]
      }
    ]
  }
}