Match

PreviousMatchlist NextMMR History

Last updated 9 months ago

get

Get Match Deatils

Authorizations

Path parameters

matchidstring · uuidRequiredExample: 696848f3-f16f-45bf-af13-e2192f81a600

Responses

200

Match data

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

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/match/{matchid} HTTP/1.1
Host: api.henrikdev.xyz
Authorization: YOUR_API_KEY
Accept: */*

{
  "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
        }
      ]
    },
    "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"
      }
    ],
    "teams": {
      "red": {
        "has_won": true,
        "rounds_won": 13,
        "rounds_lost": 10,
        "roaster": {
          "members": [
            "text"
          ],
          "name": "text",
          "tag": "text",
          "customization": {
            "icon": "text",
            "image": "text",
            "primary": "text",
            "secondary": "text",
            "tertiary": "text"
          }
        }
      },
      "blue": {
        "has_won": true,
        "rounds_won": 13,
        "rounds_lost": 10,
        "roaster": {
          "members": [
            "text"
          ],
          "name": "text",
          "tag": "text",
          "customization": {
            "icon": "text",
            "image": "text",
            "primary": "text",
            "secondary": "text",
            "tertiary": "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_events": [
              {
                "receiver_puuid": "54942ced-1967-5f66-8a16-1e0dae875641",
                "receiver_display_name": "Henrik3#EUW3",
                "receiver_team": "Red",
                "bodyshots": 3,
                "damage": 156,
                "headshots": 1,
                "legshots": 0
              }
            ],
            "damage": 282,
            "bodyshots": 7,
            "headshots": 1,
            "legshots": 1,
            "kill_events": [
              {
                "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": [
                  {
                    "player_puuid": "54942ced-1967-5f66-8a16-1e0dae875641",
                    "player_display_name": "Henrik3#EUW3",
                    "player_team": "Red",
                    "location": {
                      "x": 5177,
                      "y": -8908
                    },
                    "view_radians": 0.5277854
                  }
                ],
                "assistants": [
                  {
                    "assistant_puuid": "54942ced-1967-5f66-8a16-1e0dae875641",
                    "assistant_display_name": "Henrik3#EUW3",
                    "assistant_team": "Red"
                  }
                ]
              }
            ],
            "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
          }
        ]
      }
    ],
    "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": [
          {
            "player_puuid": "54942ced-1967-5f66-8a16-1e0dae875641",
            "player_display_name": "Henrik3#EUW3",
            "player_team": "Red",
            "location": {
              "x": 5177,
              "y": -8908
            },
            "view_radians": 0.5277854
          }
        ],
        "assistants": [
          {
            "assistant_puuid": "54942ced-1967-5f66-8a16-1e0dae875641",
            "assistant_display_name": "Henrik3#EUW3",
            "assistant_team": "Red"
          }
        ]
      }
    ]
  }
}

{
  "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-05-12T02:59:40.584Z",
      "is_completed": true,
      "queue": {
        "id": "competitive",
        "name": "Competitive",
        "mode_type": "Standard"
      },
      "season": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "short": "e1a1"
      },
      "platform": "pc",
      "premier": {},
      "party_rr_penaltys": [
        {
          "party_id": "123e4567-e89b-12d3-a456-426614174000",
          "penalty": 1
        }
      ],
      "region": "eu",
      "cluster": "Frankfurt 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",
          "members": [
            "123e4567-e89b-12d3-a456-426614174000"
          ],
          "customization": {
            "icon": "text",
            "image": "123e4567-e89b-12d3-a456-426614174000",
            "primary_color": "#000000",
            "secondary_color": "#252525",
            "tertiary_color": "#ffffff"
          }
        }
      }
    ],
    "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"
            },
            "damage_events": [
              {
                "puuid": "123e4567-e89b-12d3-a456-426614174000",
                "name": "Henrik3",
                "tag": "VALO",
                "team": "Red",
                "bodyshots": 1,
                "headshots": 1,
                "legshots": 1,
                "damage": 1
              }
            ],
            "stats": {
              "bodyshots": 1,
              "headshots": 1,
              "legshots": 1,
              "damage": 1,
              "kills": 1,
              "assists": 1,
              "score": 1
            },
            "economy": {
              "loadout_value": 1,
              "remaining": 1,
              "weapon": {
                "id": "123e4567-e89b-12d3-a456-426614174000",
                "name": "Vandal",
                "type": "weapon"
              },
              "armor": {
                "id": "123e4567-e89b-12d3-a456-426614174000",
                "name": "Heavy Armor"
              }
            },
            "was_afk": true,
            "received_penalty": true,
            "stayed_in_spawn": true
          }
        ]
      }
    ],
    "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"
        },
        "assistants": [
          {
            "puuid": "123e4567-e89b-12d3-a456-426614174000",
            "name": "Henrik3",
            "tag": "VALO",
            "team": "Red"
          }
        ],
        "location": {
          "x": 1,
          "y": 1
        },
        "weapon": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "Vandal",
          "type": "weapon"
        },
        "secondary_fire_mode": true,
        "player_locations": [
          {
            "puuid": "123e4567-e89b-12d3-a456-426614174000",
            "name": "Henrik3",
            "tag": "VALO",
            "team": "Red",
            "view_radians": 1,
            "location": {
              "x": 1,
              "y": 1
            }
          }
        ]
      }
    ]
  }
}