HenrikDev API
  • Hello and welcome :D
  • Authentication & Authorization
  • VALORANT
    • General
    • Changes
      • v4.2.0
      • v4.1.0
      • v4.0.1
      • v4.0.0
    • Error Codes
    • API Reference
      • Accounts
      • Content
      • Crosshair
      • Esports
      • Leaderboard
      • Matchlist
      • Match
      • MMR History
      • MMR
      • Premier
      • Queue Status
      • Raw
      • Status
      • Stored Data
      • Store (no daily stores)
      • Version
      • Website
Powered by GitBook
On this page
  1. VALORANT
  2. API Reference

MMR

PreviousMMR HistoryNextPremier

Last updated 10 months ago

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
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
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-05-12T04:06:03.494Z"
      }
    },
    "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-05-12T04:06:03.494Z"
        },
        "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
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
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-05-12T04:06:03.494Z"
      }
    },
    "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-05-12T04:06:03.494Z"
        },
        "act_wins": [
          {
            "id": 1,
            "name": "Unrated"
          }
        ]
      }
    ]
  }
}
  • GET/valorant/v2/mmr/{region}/{name}/{tag}
  • GET/valorant/v3/mmr/{region}/{platform}/{name}/{tag}
  • GET/valorant/v2/by-puuid/mmr/{region}/{puuid}
  • GET/valorant/v3/by-puuid/mmr/{region}/{platform}/{puuid}