MMR

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

Get a more detailed response for all MMR data

Get mmr details

get

/valorant/v2/mmr/{region}//{name}//{tag}

Authorizations

Path parameters

namestringrequired

tagstringrequired

regionstring · enumrequired

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

Options: eu, na, latam, br, ap, kr

Query parameters

seasonstring · enum

Available for v2 mmr only

Options: e1a1, e1a2, e1a3, e2a1, e2a2, e2a3, e3a1, e3a2, e3a3, e4a1, e4a2, e4a3, e5a1, e5a2, e5a3, e6a1, e6a2, e6a3, e7a1, e7a2, e7a3, e8a1, e8a2, e8a3, e9a1, e9a2, e9a3

Responses

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.henrikdev.xyz/valorant/v2/mmr/{region}/{name}/{tag}' \
  --header 'Authorization: YOUR_API_KEY'

200

400

403

404

408

410

429

501

503

200

{
  "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",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e6a2": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e6a1": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e5a3": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e5a2": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e5a1": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e4a3": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e4a2": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e4a1": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e3a3": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e3a2": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e3a1": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e2a3": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e2a2": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e2a1": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e1a3": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e1a2": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e1a1": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      }
    }
  }
}

MMR Details

Get MMR details, leaderboard placement and more

get

/valorant/v3/mmr/{region}//{platform}//{name}//{tag}

Authorizations

Path parameters

regionstring · enumrequired

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

Options: eu, na, latam, br, ap, kr

namestringrequired

Name of the user

tagstringrequired

Tag of the user

platformstring · enumrequired

Platform (console/pc)

Options: pc, console

Responses

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.henrikdev.xyz/valorant/v3/mmr/{region}/{platform}/{name}/{tag}' \
  --header 'Authorization: YOUR_API_KEY'

200

400

403

404

408

410

429

501

503

200

{
  "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-02-21T21:36:08.326Z"
      }
    },
    "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-02-21T21:36:08.326Z"
        },
        "act_wins": [
          {
            "id": 1,
            "name": "Unrated"
          }
        ]
      }
    ]
  }
}

MMR response

Get MMR Details

get

/valorant/v2/by-puuid/mmr/{region}//{puuid}

Authorizations

Path parameters

regionstring · enumrequired

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

Options: eu, na, latam, br, ap, kr

puuidstringrequired

PUUID of the user

Query parameters

seasonstring · enum

Available for v2 MMR

Options: e1a1, e1a2, e1a3, e2a1, e2a2, e2a3, e3a1, e3a2, e3a3, e4a1, e4a2, e4a3, e5a1, e5a2, e5a3, e6a1, e6a2, e6a3, e7a1, e7a2, e7a3, e8a1, e8a2, e8a3, e9a1, e9a2, e9a3

Responses

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.henrikdev.xyz/valorant/v2/by-puuid/mmr/{region}/{puuid}' \
  --header 'Authorization: YOUR_API_KEY'

200

400

403

404

408

410

429

501

503

200

{
  "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",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e6a2": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e6a1": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e5a3": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e5a2": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e5a1": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e4a3": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e4a2": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e4a1": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e3a3": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e3a2": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e3a1": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e2a3": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e2a2": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e2a1": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e1a3": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e1a2": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      },
      "e1a1": {
        "error": false,
        "wins": 12,
        "number_of_games": 24,
        "final_rank": 12,
        "final_rank_patched": "Gold 1",
        "old": true,
        "act_rank_wins": [
          {
            "patched_tier": "Gold 1",
            "tier": 12
          }
        ]
      }
    }
  }
}

MMR Details

Get MMR details, leaderboard placement and more

get

/valorant/v3/by-puuid/mmr/{region}//{platform}//{puuid}

Authorizations

Path parameters

regionstring · enumrequired

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

Options: eu, na, latam, br, ap, kr

puuidstringrequired

PUUID of the user

platformstring · enumrequired

Platform (console/pc)

Options: pc, console

Responses

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.henrikdev.xyz/valorant/v3/by-puuid/mmr/{region}/{platform}/{puuid}' \
  --header 'Authorization: YOUR_API_KEY'

200

400

403

404

408

410

429

501

503

200

{
  "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-02-21T21:36:08.326Z"
      }
    },
    "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-02-21T21:36:08.326Z"
        },
        "act_wins": [
          {
            "id": 1,
            "name": "Unrated"
          }
        ]
      }
    ]
  }
}

MMR response