Matchlist
Last updated
Last updated
You may also want to check out stored matches as a data starting point for new users in your application
Here you can get the matchlist of an user
Get Match History
/valorant/v4/by-puuid/matches/{region}//{platform}//{puuid}
eu, na, latam, br, ap, krpc, consolecompetitive, custom, deathmatch, escalation, teamdeathmatch, newmap, replication, snowballfight, spikerush, swiftplay, unratedFilter by map
Ascent, Split, Fracture, Bind, Breeze, District, Kasbah, Piazza, Lotus, Pearl, Icebox, HavenHow many matches should be returned
Pagination starting point
curl -L \
--url 'https://api.henrikdev.xyz/valorant/v4/by-puuid/matches/{region}/{platform}/{puuid}' \
--header 'Authorization: YOUR_API_KEY'{
"status": 200,
"data": [
{
"metadata": {
"match_id": "123e4567-e89b-12d3-a456-426614174000",
"map": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Ascent"
},
"game_version": "release-08.11-shipping-51-2606987",
"game_length_in_ms": 1,
"started_at": "2025-02-22T10:22:27.234Z",
"is_completed": true,
"queue": {
"id": "competitive",
"name": "Competitive",
"mode_type": "Standard"
},
"season": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"short": "e1a1"
},
"platform": "pc",
"premier": {},
"region": "eu",
"cluster": "Frankfurt 1",
"party_rr_penaltys": [
{
"party_id": "123e4567-e89b-12d3-a456-426614174000",
"penalty": 1
}
]
},
"players": [
{
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"name": "Henrik3",
"tag": "VALO",
"team_id": "Red",
"platform": "xbox",
"party_id": "123e4567-e89b-12d3-a456-426614174000",
"agent": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Sova"
},
"stats": {
"score": 1,
"kills": 1,
"deaths": 1,
"assists": 1,
"headshots": 1,
"legshots": 1,
"bodyshots": 1,
"damage": {
"dealt": 1,
"received": 1
}
},
"ability_casts": {
"grenade": 1,
"ability_1": 1,
"ability_2": 1,
"ultimate": 1
},
"tier": {
"id": 1,
"name": "Diamond 1"
},
"card_id": "123e4567-e89b-12d3-a456-426614174000",
"title_id": "123e4567-e89b-12d3-a456-426614174000",
"prefered_level_border": "123e4567-e89b-12d3-a456-426614174000",
"account_level": 1,
"session_playtime_in_ms": 1,
"behavior": {
"afk_rounds": 1,
"friendly_fire": {
"incoming": 1,
"outgoing": 1
},
"rounds_in_spawn": 1
},
"economy": {
"spent": {
"overall": 1,
"average": 1
},
"loadout_value": {
"overall": 1,
"average": 1
}
}
}
],
"observers": [
{
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"name": "HunterNation",
"tag": "OBSV",
"account_level": 1,
"session_playtime_in_ms": 1,
"card_id": "123e4567-e89b-12d3-a456-426614174000",
"title_id": "123e4567-e89b-12d3-a456-426614174000",
"party_id": "123e4567-e89b-12d3-a456-426614174000"
}
],
"coaches": [
{
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"team_id": "Red"
}
],
"teams": [
{
"team_id": "Red",
"rounds": {
"won": 1,
"lost": 1
},
"won": true,
"premier_roster": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "VALO DE",
"tag": "VALO",
"customization": {
"icon": "text",
"image": "123e4567-e89b-12d3-a456-426614174000",
"primary_color": "#000000",
"secondary_color": "#252525",
"tertiary_color": "#ffffff"
},
"members": [
"123e4567-e89b-12d3-a456-426614174000"
]
}
}
],
"rounds": [
{
"id": 1,
"result": "Detonate",
"ceremony": "CeremonyCloser",
"winning_team": "Red",
"plant": {
"round_time_in_ms": 1,
"site": "B",
"location": {
"x": 1,
"y": 1
},
"player": {
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"name": "Henrik3",
"tag": "VALO",
"team": "Red"
},
"player_locations": [
{
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"name": "Henrik3",
"tag": "VALO",
"team": "Red",
"view_radians": 1,
"location": {
"x": 1,
"y": 1
}
}
]
},
"defuse": {
"round_time_in_ms": 1,
"location": {
"x": 1,
"y": 1
},
"player": {
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"name": "Henrik3",
"tag": "VALO",
"team": "Red"
},
"player_locations": [
{
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"name": "Henrik3",
"tag": "VALO",
"team": "Red",
"view_radians": 1,
"location": {
"x": 1,
"y": 1
}
}
]
},
"stats": [
{
"ability_casts": {
"grenade": 1,
"ability_1": 1,
"ability_2": 1,
"ultimate": 1
},
"player": {
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"name": "Henrik3",
"tag": "VALO",
"team": "Red"
},
"stats": {
"bodyshots": 1,
"headshots": 1,
"legshots": 1,
"damage": 1,
"kills": 1,
"assists": 1,
"score": 1
},
"economy": {
"loadout_value": 1,
"remaining": 1,
"weapon": {
"id": "text",
"name": "Vandal",
"type": "weapon"
},
"armor": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Heavy Armor"
}
},
"was_afk": true,
"received_penalty": true,
"stayed_in_spawn": true,
"damage_events": [
{
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"name": "Henrik3",
"tag": "VALO",
"team": "Red",
"bodyshots": 1,
"headshots": 1,
"legshots": 1,
"damage": 1
}
]
}
]
}
],
"kills": [
{
"round": 1,
"time_in_round_in_ms": 1,
"time_in_match_in_ms": 1,
"killer": {
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"name": "Henrik3",
"tag": "VALO",
"team": "Red"
},
"victim": {
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"name": "Henrik3",
"tag": "VALO",
"team": "Red"
},
"location": {
"x": 1,
"y": 1
},
"weapon": {
"id": "text",
"name": "Vandal",
"type": "weapon"
},
"secondary_fire_mode": true,
"assistants": [
{
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"name": "Henrik3",
"tag": "VALO",
"team": "Red"
}
],
"player_locations": [
{
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"name": "Henrik3",
"tag": "VALO",
"team": "Red",
"view_radians": 1,
"location": {
"x": 1,
"y": 1
}
}
]
}
]
}
]
}Array of matches
Get Match History
/valorant/v4/matches/{region}//{platform}//{name}//{tag}
eu, na, latam, br, ap, krpc, consolecompetitive, custom, deathmatch, escalation, teamdeathmatch, newmap, replication, snowballfight, spikerush, swiftplay, unratedFilter by map
Ascent, Split, Fracture, Bind, Breeze, District, Kasbah, Piazza, Lotus, Pearl, Icebox, HavenHow many matches should be returned
Pagination starting point
curl -L \
--url 'https://api.henrikdev.xyz/valorant/v4/matches/{region}/{platform}/{name}/{tag}' \
--header 'Authorization: YOUR_API_KEY'{
"status": 200,
"data": [
{
"metadata": {
"match_id": "123e4567-e89b-12d3-a456-426614174000",
"map": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Ascent"
},
"game_version": "release-08.11-shipping-51-2606987",
"game_length_in_ms": 1,
"started_at": "2025-02-22T10:22:27.234Z",
"is_completed": true,
"queue": {
"id": "competitive",
"name": "Competitive",
"mode_type": "Standard"
},
"season": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"short": "e1a1"
},
"platform": "pc",
"premier": {},
"region": "eu",
"cluster": "Frankfurt 1",
"party_rr_penaltys": [
{
"party_id": "123e4567-e89b-12d3-a456-426614174000",
"penalty": 1
}
]
},
"players": [
{
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"name": "Henrik3",
"tag": "VALO",
"team_id": "Red",
"platform": "xbox",
"party_id": "123e4567-e89b-12d3-a456-426614174000",
"agent": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Sova"
},
"stats": {
"score": 1,
"kills": 1,
"deaths": 1,
"assists": 1,
"headshots": 1,
"legshots": 1,
"bodyshots": 1,
"damage": {
"dealt": 1,
"received": 1
}
},
"ability_casts": {
"grenade": 1,
"ability_1": 1,
"ability_2": 1,
"ultimate": 1
},
"tier": {
"id": 1,
"name": "Diamond 1"
},
"card_id": "123e4567-e89b-12d3-a456-426614174000",
"title_id": "123e4567-e89b-12d3-a456-426614174000",
"prefered_level_border": "123e4567-e89b-12d3-a456-426614174000",
"account_level": 1,
"session_playtime_in_ms": 1,
"behavior": {
"afk_rounds": 1,
"friendly_fire": {
"incoming": 1,
"outgoing": 1
},
"rounds_in_spawn": 1
},
"economy": {
"spent": {
"overall": 1,
"average": 1
},
"loadout_value": {
"overall": 1,
"average": 1
}
}
}
],
"observers": [
{
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"name": "HunterNation",
"tag": "OBSV",
"account_level": 1,
"session_playtime_in_ms": 1,
"card_id": "123e4567-e89b-12d3-a456-426614174000",
"title_id": "123e4567-e89b-12d3-a456-426614174000",
"party_id": "123e4567-e89b-12d3-a456-426614174000"
}
],
"coaches": [
{
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"team_id": "Red"
}
],
"teams": [
{
"team_id": "Red",
"rounds": {
"won": 1,
"lost": 1
},
"won": true,
"premier_roster": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "VALO DE",
"tag": "VALO",
"customization": {
"icon": "text",
"image": "123e4567-e89b-12d3-a456-426614174000",
"primary_color": "#000000",
"secondary_color": "#252525",
"tertiary_color": "#ffffff"
},
"members": [
"123e4567-e89b-12d3-a456-426614174000"
]
}
}
],
"rounds": [
{
"id": 1,
"result": "Detonate",
"ceremony": "CeremonyCloser",
"winning_team": "Red",
"plant": {
"round_time_in_ms": 1,
"site": "B",
"location": {
"x": 1,
"y": 1
},
"player": {
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"name": "Henrik3",
"tag": "VALO",
"team": "Red"
},
"player_locations": [
{
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"name": "Henrik3",
"tag": "VALO",
"team": "Red",
"view_radians": 1,
"location": {
"x": 1,
"y": 1
}
}
]
},
"defuse": {
"round_time_in_ms": 1,
"location": {
"x": 1,
"y": 1
},
"player": {
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"name": "Henrik3",
"tag": "VALO",
"team": "Red"
},
"player_locations": [
{
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"name": "Henrik3",
"tag": "VALO",
"team": "Red",
"view_radians": 1,
"location": {
"x": 1,
"y": 1
}
}
]
},
"stats": [
{
"ability_casts": {
"grenade": 1,
"ability_1": 1,
"ability_2": 1,
"ultimate": 1
},
"player": {
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"name": "Henrik3",
"tag": "VALO",
"team": "Red"
},
"stats": {
"bodyshots": 1,
"headshots": 1,
"legshots": 1,
"damage": 1,
"kills": 1,
"assists": 1,
"score": 1
},
"economy": {
"loadout_value": 1,
"remaining": 1,
"weapon": {
"id": "text",
"name": "Vandal",
"type": "weapon"
},
"armor": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Heavy Armor"
}
},
"was_afk": true,
"received_penalty": true,
"stayed_in_spawn": true,
"damage_events": [
{
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"name": "Henrik3",
"tag": "VALO",
"team": "Red",
"bodyshots": 1,
"headshots": 1,
"legshots": 1,
"damage": 1
}
]
}
]
}
],
"kills": [
{
"round": 1,
"time_in_round_in_ms": 1,
"time_in_match_in_ms": 1,
"killer": {
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"name": "Henrik3",
"tag": "VALO",
"team": "Red"
},
"victim": {
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"name": "Henrik3",
"tag": "VALO",
"team": "Red"
},
"location": {
"x": 1,
"y": 1
},
"weapon": {
"id": "text",
"name": "Vandal",
"type": "weapon"
},
"secondary_fire_mode": true,
"assistants": [
{
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"name": "Henrik3",
"tag": "VALO",
"team": "Red"
}
],
"player_locations": [
{
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"name": "Henrik3",
"tag": "VALO",
"team": "Red",
"view_radians": 1,
"location": {
"x": 1,
"y": 1
}
}
]
}
]
}
]
}Array of matches
Get Match History
/valorant/v3/matches/{region}//{name}//{tag}
eu, na, latam, br, ap, krcompetitive, custom, deathmatch, escalation, teamdeathmatch, newmap, replication, snowballfight, spikerush, swiftplay, unratedFilter by map
Ascent, Split, Fracture, Bind, Breeze, District, Kasbah, Piazza, Lotus, Pearl, Icebox, HavenHow many matches should be returned
curl -L \
--url 'https://api.henrikdev.xyz/valorant/v3/matches/{region}/{name}/{tag}' \
--header 'Authorization: YOUR_API_KEY'{
"status": 200,
"data": [
{
"metadata": {
"map": "Ascent",
"game_version": "release-03.12-shipping-16-649370",
"game_length": 2356581,
"game_start": 1641934366,
"game_start_patched": "Tuesday, January 11, 2022 9:52 PM",
"rounds_played": 23,
"mode": "Competitive",
"mode_id": "competitive",
"queue": "Standard",
"season_id": "123e4567-e89b-12d3-a456-426614174000",
"platform": "PC",
"matchid": "123e4567-e89b-12d3-a456-426614174000",
"premier_info": {
"tournament_id": "text",
"matchup_id": "text"
},
"region": "eu",
"cluster": "London"
},
"players": {
"all_players": [
{
"puuid": "54942ced-1967-5f66-8a16-1e0dae875641",
"name": "Henrik3",
"tag": "EUW3",
"team": "Red",
"level": 104,
"character": "Sova",
"currenttier": 12,
"currenttier_patched": "Gold 1",
"player_card": "8edf22c5-4489-ab41-769a-07adb4c454d6",
"player_title": "e3ca05a4-4e44-9afe-3791-7d96ca8f71fa",
"party_id": "b7590bd4-e2c9-4dd3-8cbf-05f04158375e",
"session_playtime": {
"minutes": 26,
"seconds": 1560,
"milliseconds": 1560000
},
"assets": {
"card": {
"small": "https://media.valorant-api.com/playercards/8edf22c5-4489-ab41-769a-07adb4c454d6/smallart.png",
"large": "https://media.valorant-api.com/playercards/8edf22c5-4489-ab41-769a-07adb4c454d6/largeart.png",
"wide": "https://media.valorant-api.com/playercards/8edf22c5-4489-ab41-769a-07adb4c454d6/wideart.png"
},
"agent": {
"small": "https://media.valorant-api.com/agents/320b2a48-4d9b-a075-30f1-1f93a9b638fa/displayicon.png",
"full": "https://media.valorant-api.com/agents/320b2a48-4d9b-a075-30f1-1f93a9b638fa/fullportrait.png",
"bust": "https://media.valorant-api.com/agents/320b2a48-4d9b-a075-30f1-1f93a9b638fa/bustportrait.png",
"killfeed": "https://media.valorant-api.com/agents/320b2a48-4d9b-a075-30f1-1f93a9b638fa/killfeedportrait.png"
}
},
"behaviour": {
"afk_rounds": 0,
"friendly_fire": {
"incoming": 0,
"outgoing": 0
},
"rounds_in_spawn": 0
},
"platform": {
"type": "PC",
"os": {
"name": "Windows",
"version": "10.0.22000.1.768.64bit"
}
},
"ability_casts": {
"c_cast": 16,
"q_cast": 5,
"e_cast": 26,
"x_cast": 0
},
"stats": {
"score": 4869,
"kills": 18,
"deaths": 18,
"assists": 5,
"bodyshots": 48,
"headshots": 9,
"legshots": 5
},
"economy": {
"spent": {
"overall": 59750,
"average": 2598
},
"loadout_value": {
"overall": 71700,
"average": 3117
}
},
"damage_made": 3067,
"damage_received": 3115
}
],
"red": [
{
"puuid": "54942ced-1967-5f66-8a16-1e0dae875641",
"name": "Henrik3",
"tag": "EUW3",
"team": "Red",
"level": 104,
"character": "Sova",
"currenttier": 12,
"currenttier_patched": "Gold 1",
"player_card": "8edf22c5-4489-ab41-769a-07adb4c454d6",
"player_title": "e3ca05a4-4e44-9afe-3791-7d96ca8f71fa",
"party_id": "b7590bd4-e2c9-4dd3-8cbf-05f04158375e",
"session_playtime": {
"minutes": 26,
"seconds": 1560,
"milliseconds": 1560000
},
"assets": {
"card": {
"small": "https://media.valorant-api.com/playercards/8edf22c5-4489-ab41-769a-07adb4c454d6/smallart.png",
"large": "https://media.valorant-api.com/playercards/8edf22c5-4489-ab41-769a-07adb4c454d6/largeart.png",
"wide": "https://media.valorant-api.com/playercards/8edf22c5-4489-ab41-769a-07adb4c454d6/wideart.png"
},
"agent": {
"small": "https://media.valorant-api.com/agents/320b2a48-4d9b-a075-30f1-1f93a9b638fa/displayicon.png",
"full": "https://media.valorant-api.com/agents/320b2a48-4d9b-a075-30f1-1f93a9b638fa/fullportrait.png",
"bust": "https://media.valorant-api.com/agents/320b2a48-4d9b-a075-30f1-1f93a9b638fa/bustportrait.png",
"killfeed": "https://media.valorant-api.com/agents/320b2a48-4d9b-a075-30f1-1f93a9b638fa/killfeedportrait.png"
}
},
"behaviour": {
"afk_rounds": 0,
"friendly_fire": {
"incoming": 0,
"outgoing": 0
},
"rounds_in_spawn": 0
},
"platform": {
"type": "PC",
"os": {
"name": "Windows",
"version": "10.0.22000.1.768.64bit"
}
},
"ability_casts": {
"c_cast": 16,
"q_cast": 5,
"e_cast": 26,
"x_cast": 0
},
"stats": {
"score": 4869,
"kills": 18,
"deaths": 18,
"assists": 5,
"bodyshots": 48,
"headshots": 9,
"legshots": 5
},
"economy": {
"spent": {
"overall": 59750,
"average": 2598
},
"loadout_value": {
"overall": 71700,
"average": 3117
}
},
"damage_made": 3067,
"damage_received": 3115
}
],
"blue": [
{
"puuid": "54942ced-1967-5f66-8a16-1e0dae875641",
"name": "Henrik3",
"tag": "EUW3",
"team": "Red",
"level": 104,
"character": "Sova",
"currenttier": 12,
"currenttier_patched": "Gold 1",
"player_card": "8edf22c5-4489-ab41-769a-07adb4c454d6",
"player_title": "e3ca05a4-4e44-9afe-3791-7d96ca8f71fa",
"party_id": "b7590bd4-e2c9-4dd3-8cbf-05f04158375e",
"session_playtime": {
"minutes": 26,
"seconds": 1560,
"milliseconds": 1560000
},
"assets": {
"card": {
"small": "https://media.valorant-api.com/playercards/8edf22c5-4489-ab41-769a-07adb4c454d6/smallart.png",
"large": "https://media.valorant-api.com/playercards/8edf22c5-4489-ab41-769a-07adb4c454d6/largeart.png",
"wide": "https://media.valorant-api.com/playercards/8edf22c5-4489-ab41-769a-07adb4c454d6/wideart.png"
},
"agent": {
"small": "https://media.valorant-api.com/agents/320b2a48-4d9b-a075-30f1-1f93a9b638fa/displayicon.png",
"full": "https://media.valorant-api.com/agents/320b2a48-4d9b-a075-30f1-1f93a9b638fa/fullportrait.png",
"bust": "https://media.valorant-api.com/agents/320b2a48-4d9b-a075-30f1-1f93a9b638fa/bustportrait.png",
"killfeed": "https://media.valorant-api.com/agents/320b2a48-4d9b-a075-30f1-1f93a9b638fa/killfeedportrait.png"
}
},
"behaviour": {
"afk_rounds": 0,
"friendly_fire": {
"incoming": 0,
"outgoing": 0
},
"rounds_in_spawn": 0
},
"platform": {
"type": "PC",
"os": {
"name": "Windows",
"version": "10.0.22000.1.768.64bit"
}
},
"ability_casts": {
"c_cast": 16,
"q_cast": 5,
"e_cast": 26,
"x_cast": 0
},
"stats": {
"score": 4869,
"kills": 18,
"deaths": 18,
"assists": 5,
"bodyshots": 48,
"headshots": 9,
"legshots": 5
},
"economy": {
"spent": {
"overall": 59750,
"average": 2598
},
"loadout_value": {
"overall": 71700,
"average": 3117
}
},
"damage_made": 3067,
"damage_received": 3115
}
]
},
"teams": {
"red": {
"has_won": true,
"rounds_won": 13,
"rounds_lost": 10,
"roaster": {
"name": "text",
"tag": "text",
"customization": {
"icon": "text",
"image": "text",
"primary": "text",
"secondary": "text",
"tertiary": "text"
},
"members": [
"text"
]
}
},
"blue": {
"has_won": true,
"rounds_won": 13,
"rounds_lost": 10,
"roaster": {
"name": "text",
"tag": "text",
"customization": {
"icon": "text",
"image": "text",
"primary": "text",
"secondary": "text",
"tertiary": "text"
},
"members": [
"text"
]
}
}
},
"observers": [
{
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"tag": "text",
"platform": {
"type": "PC",
"os": {
"name": "Windows",
"version": "10.0.22000.1.768.64bit"
}
},
"session_playtime": {
"minutes": 26,
"seconds": 1560,
"milliseconds": 1560000
},
"team": "text",
"level": 1,
"player_card": "123e4567-e89b-12d3-a456-426614174000",
"player_title": "123e4567-e89b-12d3-a456-426614174000",
"party_id": "123e4567-e89b-12d3-a456-426614174000"
}
],
"coaches": [
{
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"team": "text"
}
],
"rounds": [
{
"winning_team": "Red",
"end_type": "Eliminated",
"bomb_planted": true,
"bomb_defused": false,
"plant_events": {
"plant_location": {
"x": -1325,
"y": -1325
},
"planted_by": {
"puuid": "54942ced-1967-5f66-8a16-1e0dae875641",
"display_name": "Henrik3#EUW3",
"team": "Red"
},
"plant_site": "A",
"plant_time_in_round": 26345,
"player_locations_on_plant": [
{
"player_puuid": "54942ced-1967-5f66-8a16-1e0dae875641",
"player_display_name": "Henrik3#EUW3",
"player_team": "Red",
"location": {
"x": 5177,
"y": -8908
},
"view_radians": 0.5277854
}
]
},
"defuse_events": {
"defuse_location": {
"x": -1325,
"y": -1325
},
"defused_by": {
"puuid": "54942ced-1967-5f66-8a16-1e0dae875641",
"display_name": "Henrik3#EUW3",
"team": "Red"
},
"defuse_time_in_round": 26345,
"player_locations_on_defuse": [
{
"player_puuid": "54942ced-1967-5f66-8a16-1e0dae875641",
"player_display_name": "Henrik3#EUW3",
"player_team": "Red",
"location": {
"x": 5177,
"y": -8908
},
"view_radians": 0.5277854
}
]
},
"player_stats": [
{
"ability_casts": {
"c_casts": 2,
"q_casts": 5,
"e_casts": 20,
"x_casts": 1
},
"player_puuid": "54942ced-1967-5f66-8a16-1e0dae875641",
"player_display_name": "Henrik3#EUW3",
"player_team": "Red",
"damage": 282,
"bodyshots": 7,
"headshots": 1,
"legshots": 1,
"kills": 2,
"score": 430,
"economy": {
"loadout_value": 3900,
"weapon": {
"id": "462080D1-4035-2937-7C09-27AA2A5C27A7",
"name": "Spectre",
"assets": {
"display_icon": "https://media.valorant-api.com/weapons/462080d1-4035-2937-7c09-27aa2a5c27a7/displayicon.png",
"killfeed_icon": "https://media.valorant-api.com/weapons/462080d1-4035-2937-7c09-27aa2a5c27a7/killstreamicon.png"
}
},
"armor": {
"id": "822BCAB2-40A2-324E-C137-E09195AD7692",
"name": "Heavy Shields",
"assets": {
"display_icon": "https://media.valorant-api.com/gear/822bcab2-40a2-324e-c137-e09195ad7692/displayicon.png"
}
},
"remaining": 5300,
"spent": 1550
},
"was_afk": false,
"was_penalized": false,
"stayed_in_spawn": false,
"damage_events": [],
"kill_events": []
}
]
}
],
"kills": [
{
"kill_time_in_round": 43163,
"kill_time_in_match": 890501,
"killer_puuid": "54942ced-1967-5f66-8a16-1e0dae875641",
"killer_display_name": "Henrik3#EUW3",
"killer_team": "Red",
"victim_puuid": "54942ced-1967-5f66-8a16-1e0dae875641",
"victim_display_name": "Henrik3#EUW3",
"victim_team": "Red",
"victim_death_location": {
"x": 7266,
"y": -5096
},
"damage_weapon_id": "9C82E19D-4575-0200-1A81-3EACF00CF872",
"damage_weapon_name": "Vandal",
"damage_weapon_assets": {
"display_icon": "https://media.valorant-api.com/weapons/9c82e19d-4575-0200-1a81-3eacf00cf872/displayicon.png",
"killfeed_icon": "https://media.valorant-api.com/weapons/9c82e19d-4575-0200-1a81-3eacf00cf872/killstreamicon.png"
},
"secondary_fire_mode": false,
"player_locations_on_kill": [],
"assistants": []
}
]
}
]
}Array of Match data
Get Match History
/valorant/v3/by-puuid/matches/{region}//{puuid}
Choose from ap, br, eu, kr, latam, na (br and latam will be internally converted to na)
eu, na, latam, br, ap, krPUUID of the user
competitive, custom, deathmatch, escalation, teamdeathmatch, newmap, replication, snowballfight, spikerush, swiftplay, unratedAvailable for v3 matches
Ascent, Split, Fracture, Bind, Breeze, District, Kasbah, Piazza, Lotus, Pearl, Icebox, HavenAvailable for v3 matches (how many matches should be returned)
curl -L \
--url 'https://api.henrikdev.xyz/valorant/v3/by-puuid/matches/{region}/{puuid}' \
--header 'Authorization: YOUR_API_KEY'{
"status": "200",
"data": [
{
"metadata": {
"map": "Ascent",
"game_version": "release-03.12-shipping-16-649370",
"game_length": 2356581,
"game_start": 1641934366,
"game_start_patched": "Tuesday, January 11, 2022 9:52 PM",
"rounds_played": 23,
"mode": "Competitive",
"mode_id": "competitive",
"queue": "Standard",
"season_id": "123e4567-e89b-12d3-a456-426614174000",
"platform": "PC",
"matchid": "123e4567-e89b-12d3-a456-426614174000",
"premier_info": {
"tournament_id": "text",
"matchup_id": "text"
},
"region": "eu",
"cluster": "London"
},
"players": {
"all_players": [
{
"puuid": "54942ced-1967-5f66-8a16-1e0dae875641",
"name": "Henrik3",
"tag": "EUW3",
"team": "Red",
"level": 104,
"character": "Sova",
"currenttier": 12,
"currenttier_patched": "Gold 1",
"player_card": "8edf22c5-4489-ab41-769a-07adb4c454d6",
"player_title": "e3ca05a4-4e44-9afe-3791-7d96ca8f71fa",
"party_id": "b7590bd4-e2c9-4dd3-8cbf-05f04158375e",
"session_playtime": {
"minutes": 26,
"seconds": 1560,
"milliseconds": 1560000
},
"assets": {
"card": {
"small": "https://media.valorant-api.com/playercards/8edf22c5-4489-ab41-769a-07adb4c454d6/smallart.png",
"large": "https://media.valorant-api.com/playercards/8edf22c5-4489-ab41-769a-07adb4c454d6/largeart.png",
"wide": "https://media.valorant-api.com/playercards/8edf22c5-4489-ab41-769a-07adb4c454d6/wideart.png"
},
"agent": {
"small": "https://media.valorant-api.com/agents/320b2a48-4d9b-a075-30f1-1f93a9b638fa/displayicon.png",
"full": "https://media.valorant-api.com/agents/320b2a48-4d9b-a075-30f1-1f93a9b638fa/fullportrait.png",
"bust": "https://media.valorant-api.com/agents/320b2a48-4d9b-a075-30f1-1f93a9b638fa/bustportrait.png",
"killfeed": "https://media.valorant-api.com/agents/320b2a48-4d9b-a075-30f1-1f93a9b638fa/killfeedportrait.png"
}
},
"behaviour": {
"afk_rounds": 0,
"friendly_fire": {
"incoming": 0,
"outgoing": 0
},
"rounds_in_spawn": 0
},
"platform": {
"type": "PC",
"os": {
"name": "Windows",
"version": "10.0.22000.1.768.64bit"
}
},
"ability_casts": {
"c_cast": 16,
"q_cast": 5,
"e_cast": 26,
"x_cast": 0
},
"stats": {
"score": 4869,
"kills": 18,
"deaths": 18,
"assists": 5,
"bodyshots": 48,
"headshots": 9,
"legshots": 5
},
"economy": {
"spent": {
"overall": 59750,
"average": 2598
},
"loadout_value": {
"overall": 71700,
"average": 3117
}
},
"damage_made": 3067,
"damage_received": 3115
}
],
"red": [
{
"puuid": "54942ced-1967-5f66-8a16-1e0dae875641",
"name": "Henrik3",
"tag": "EUW3",
"team": "Red",
"level": 104,
"character": "Sova",
"currenttier": 12,
"currenttier_patched": "Gold 1",
"player_card": "8edf22c5-4489-ab41-769a-07adb4c454d6",
"player_title": "e3ca05a4-4e44-9afe-3791-7d96ca8f71fa",
"party_id": "b7590bd4-e2c9-4dd3-8cbf-05f04158375e",
"session_playtime": {
"minutes": 26,
"seconds": 1560,
"milliseconds": 1560000
},
"assets": {
"card": {
"small": "https://media.valorant-api.com/playercards/8edf22c5-4489-ab41-769a-07adb4c454d6/smallart.png",
"large": "https://media.valorant-api.com/playercards/8edf22c5-4489-ab41-769a-07adb4c454d6/largeart.png",
"wide": "https://media.valorant-api.com/playercards/8edf22c5-4489-ab41-769a-07adb4c454d6/wideart.png"
},
"agent": {
"small": "https://media.valorant-api.com/agents/320b2a48-4d9b-a075-30f1-1f93a9b638fa/displayicon.png",
"full": "https://media.valorant-api.com/agents/320b2a48-4d9b-a075-30f1-1f93a9b638fa/fullportrait.png",
"bust": "https://media.valorant-api.com/agents/320b2a48-4d9b-a075-30f1-1f93a9b638fa/bustportrait.png",
"killfeed": "https://media.valorant-api.com/agents/320b2a48-4d9b-a075-30f1-1f93a9b638fa/killfeedportrait.png"
}
},
"behaviour": {
"afk_rounds": 0,
"friendly_fire": {
"incoming": 0,
"outgoing": 0
},
"rounds_in_spawn": 0
},
"platform": {
"type": "PC",
"os": {
"name": "Windows",
"version": "10.0.22000.1.768.64bit"
}
},
"ability_casts": {
"c_cast": 16,
"q_cast": 5,
"e_cast": 26,
"x_cast": 0
},
"stats": {
"score": 4869,
"kills": 18,
"deaths": 18,
"assists": 5,
"bodyshots": 48,
"headshots": 9,
"legshots": 5
},
"economy": {
"spent": {
"overall": 59750,
"average": 2598
},
"loadout_value": {
"overall": 71700,
"average": 3117
}
},
"damage_made": 3067,
"damage_received": 3115
}
],
"blue": [
{
"puuid": "54942ced-1967-5f66-8a16-1e0dae875641",
"name": "Henrik3",
"tag": "EUW3",
"team": "Red",
"level": 104,
"character": "Sova",
"currenttier": 12,
"currenttier_patched": "Gold 1",
"player_card": "8edf22c5-4489-ab41-769a-07adb4c454d6",
"player_title": "e3ca05a4-4e44-9afe-3791-7d96ca8f71fa",
"party_id": "b7590bd4-e2c9-4dd3-8cbf-05f04158375e",
"session_playtime": {
"minutes": 26,
"seconds": 1560,
"milliseconds": 1560000
},
"assets": {
"card": {
"small": "https://media.valorant-api.com/playercards/8edf22c5-4489-ab41-769a-07adb4c454d6/smallart.png",
"large": "https://media.valorant-api.com/playercards/8edf22c5-4489-ab41-769a-07adb4c454d6/largeart.png",
"wide": "https://media.valorant-api.com/playercards/8edf22c5-4489-ab41-769a-07adb4c454d6/wideart.png"
},
"agent": {
"small": "https://media.valorant-api.com/agents/320b2a48-4d9b-a075-30f1-1f93a9b638fa/displayicon.png",
"full": "https://media.valorant-api.com/agents/320b2a48-4d9b-a075-30f1-1f93a9b638fa/fullportrait.png",
"bust": "https://media.valorant-api.com/agents/320b2a48-4d9b-a075-30f1-1f93a9b638fa/bustportrait.png",
"killfeed": "https://media.valorant-api.com/agents/320b2a48-4d9b-a075-30f1-1f93a9b638fa/killfeedportrait.png"
}
},
"behaviour": {
"afk_rounds": 0,
"friendly_fire": {
"incoming": 0,
"outgoing": 0
},
"rounds_in_spawn": 0
},
"platform": {
"type": "PC",
"os": {
"name": "Windows",
"version": "10.0.22000.1.768.64bit"
}
},
"ability_casts": {
"c_cast": 16,
"q_cast": 5,
"e_cast": 26,
"x_cast": 0
},
"stats": {
"score": 4869,
"kills": 18,
"deaths": 18,
"assists": 5,
"bodyshots": 48,
"headshots": 9,
"legshots": 5
},
"economy": {
"spent": {
"overall": 59750,
"average": 2598
},
"loadout_value": {
"overall": 71700,
"average": 3117
}
},
"damage_made": 3067,
"damage_received": 3115
}
]
},
"teams": {
"red": {
"has_won": true,
"rounds_won": 13,
"rounds_lost": 10,
"roaster": {
"name": "text",
"tag": "text",
"customization": {
"icon": "text",
"image": "text",
"primary": "text",
"secondary": "text",
"tertiary": "text"
},
"members": [
"text"
]
}
},
"blue": {
"has_won": true,
"rounds_won": 13,
"rounds_lost": 10,
"roaster": {
"name": "text",
"tag": "text",
"customization": {
"icon": "text",
"image": "text",
"primary": "text",
"secondary": "text",
"tertiary": "text"
},
"members": [
"text"
]
}
}
},
"observers": [
{
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"tag": "text",
"platform": {
"type": "PC",
"os": {
"name": "Windows",
"version": "10.0.22000.1.768.64bit"
}
},
"session_playtime": {
"minutes": 26,
"seconds": 1560,
"milliseconds": 1560000
},
"team": "text",
"level": 1,
"player_card": "123e4567-e89b-12d3-a456-426614174000",
"player_title": "123e4567-e89b-12d3-a456-426614174000",
"party_id": "123e4567-e89b-12d3-a456-426614174000"
}
],
"coaches": [
{
"puuid": "123e4567-e89b-12d3-a456-426614174000",
"team": "text"
}
],
"rounds": [
{
"winning_team": "Red",
"end_type": "Eliminated",
"bomb_planted": true,
"bomb_defused": false,
"plant_events": {
"plant_location": {
"x": -1325,
"y": -1325
},
"planted_by": {
"puuid": "54942ced-1967-5f66-8a16-1e0dae875641",
"display_name": "Henrik3#EUW3",
"team": "Red"
},
"plant_site": "A",
"plant_time_in_round": 26345,
"player_locations_on_plant": [
{
"player_puuid": "54942ced-1967-5f66-8a16-1e0dae875641",
"player_display_name": "Henrik3#EUW3",
"player_team": "Red",
"location": {
"x": 5177,
"y": -8908
},
"view_radians": 0.5277854
}
]
},
"defuse_events": {
"defuse_location": {
"x": -1325,
"y": -1325
},
"defused_by": {
"puuid": "54942ced-1967-5f66-8a16-1e0dae875641",
"display_name": "Henrik3#EUW3",
"team": "Red"
},
"defuse_time_in_round": 26345,
"player_locations_on_defuse": [
{
"player_puuid": "54942ced-1967-5f66-8a16-1e0dae875641",
"player_display_name": "Henrik3#EUW3",
"player_team": "Red",
"location": {
"x": 5177,
"y": -8908
},
"view_radians": 0.5277854
}
]
},
"player_stats": [
{
"ability_casts": {
"c_casts": 2,
"q_casts": 5,
"e_casts": 20,
"x_casts": 1
},
"player_puuid": "54942ced-1967-5f66-8a16-1e0dae875641",
"player_display_name": "Henrik3#EUW3",
"player_team": "Red",
"damage": 282,
"bodyshots": 7,
"headshots": 1,
"legshots": 1,
"kills": 2,
"score": 430,
"economy": {
"loadout_value": 3900,
"weapon": {
"id": "462080D1-4035-2937-7C09-27AA2A5C27A7",
"name": "Spectre",
"assets": {
"display_icon": "https://media.valorant-api.com/weapons/462080d1-4035-2937-7c09-27aa2a5c27a7/displayicon.png",
"killfeed_icon": "https://media.valorant-api.com/weapons/462080d1-4035-2937-7c09-27aa2a5c27a7/killstreamicon.png"
}
},
"armor": {
"id": "822BCAB2-40A2-324E-C137-E09195AD7692",
"name": "Heavy Shields",
"assets": {
"display_icon": "https://media.valorant-api.com/gear/822bcab2-40a2-324e-c137-e09195ad7692/displayicon.png"
}
},
"remaining": 5300,
"spent": 1550
},
"was_afk": false,
"was_penalized": false,
"stayed_in_spawn": false,
"damage_events": [],
"kill_events": []
}
]
}
],
"kills": [
{
"kill_time_in_round": 43163,
"kill_time_in_match": 890501,
"killer_puuid": "54942ced-1967-5f66-8a16-1e0dae875641",
"killer_display_name": "Henrik3#EUW3",
"killer_team": "Red",
"victim_puuid": "54942ced-1967-5f66-8a16-1e0dae875641",
"victim_display_name": "Henrik3#EUW3",
"victim_team": "Red",
"victim_death_location": {
"x": 7266,
"y": -5096
},
"damage_weapon_id": "9C82E19D-4575-0200-1A81-3EACF00CF872",
"damage_weapon_name": "Vandal",
"damage_weapon_assets": {
"display_icon": "https://media.valorant-api.com/weapons/9c82e19d-4575-0200-1a81-3eacf00cf872/displayicon.png",
"killfeed_icon": "https://media.valorant-api.com/weapons/9c82e19d-4575-0200-1a81-3eacf00cf872/killstreamicon.png"
},
"secondary_fire_mode": false,
"player_locations_on_kill": [],
"assistants": []
}
]
}
]
}Array of Match data