---
title: "Get match details (v2)"
method: GET
path: "/valorant/v2/match/{match_id}"
tags: ["valorant"]
---

# Get match details (v2)

`GET /valorant/v2/match/{match_id}`

## Path parameters

- `match_id` string, required

## Response `200`

Match details retrieved successfully

- MatchesV2Response
  - `data` MatchesV2Data, required
    - `coaches` MatchesV2DataCoach[], required
      - `puuid` string, required
      - `team` string, required
    - `kills` MatchesV2DataKill[], required
      - `assistants` MatchesV2DataRoundPlayerStatsKillEventsAssistants[], required
        - `assistant_display_name` string, required
        - `assistant_puuid` string, required
        - `assistant_team` string, required
      - `damage_weapon_assets` MatchesV2DataRoundPlayerStatsKillEventsAssets, required
        - `display_icon` string, nullable
        - `killfeed_icon` string, nullable
      - `damage_weapon_id` string, required
      - `damage_weapon_name` string, nullable
      - `kill_time_in_match` integer, required
      - `kill_time_in_round` integer, required
      - `killer_display_name` string, required
      - `killer_puuid` string, required
      - `killer_team` string, required
      - `player_locations_on_kill` MatchesV2DataRoundPlayerLocationsOnEvent[], required
        - `location` MatchesV2DataRoundEventLocation, required
          - `x` integer, required
          - `y` integer, required
        - `player_display_name` string, required
        - `player_puuid` string, required
        - `player_team` string, required
        - `view_radians` number, float, required
      - `round` integer, required
      - `secondary_fire_mode` boolean, required
      - `victim_death_location` MatchesV2DataRoundEventLocation, required
        - `x` integer, required
        - `y` integer, required
      - `victim_display_name` string, required
      - `victim_puuid` string, required
      - `victim_team` string, required
    - `metadata` MatchesV2DataMetadata, required
      - `cluster` string, nullable
      - `game_length` integer, required
      - `game_start` integer, required
      - `game_start_patched` string, required
      - `game_version` string, required
      - `map` string, nullable
      - `matchid` string, required
      - `mode` string, nullable
      - `mode_id` string, required
      - `platform` string, required
      - `premier_info` MatchesV2DataMetadataPremierInfo, required
        - `matchup_id` string, nullable
        - `tournament_id` string, nullable
      - `queue` string, nullable
      - `region` string, nullable
      - `rounds_played` integer, required
      - `season_id` string, required
    - `observers` MatchesV2DataObserver[], required
      - `level` integer, required
      - `name` string, required
      - `party_id` string, required
      - `platform` MatchesV2DataPlatform, required
        - `os` MatchesV2DataPlatformOs, required
          - `name` string, required
          - `version` string, required
        - `type` string, required
      - `player_card` string, required
      - `player_title` string, required
      - `puuid` string, required
      - `session_playtime` MatchesV2DataPlayerSessionPlaytime, required
        - `milliseconds` integer, required
        - `minutes` integer, required
        - `seconds` integer, required
      - `tag` string, required
      - `team` string, required
    - `players` MatchesV2DataPlayers, required
      - `all_players` MatchesV2DataPlayer[], required
        - `ability_casts` MatchesV2DataPlayerAbilityCasts, required
          - `c_cast` integer, nullable
          - `e_cast` integer, nullable
          - `q_cast` integer, nullable
          - `x_cast` integer, nullable
        - `assets` MatchesV2DataPlayerAssets, required
          - `agent` MatchesV2DataPlayerAssetsAgent, required
            - `bust` string, required
            - `full` string, required
            - `killfeed` string, required
            - `small` string, required
          - `card` MatchesV2DataPlayerAssetsCard, required
            - `large` string, required
            - `small` string, required
            - `wide` string, required
        - `behavior` MatchesV2DataPlayerBehavior, required
          - `afk_rounds` number, float, required
          - `friendly_fire` MatchesV2DataPlayerBehaviorFriendlyFire, required
            - `incoming` number, float, nullable
            - `outgoing` number, float, nullable
          - `rounds_in_spawn` number, float, nullable
        - `character` string, nullable
        - `currenttier` integer, required
        - `currenttier_patched` string, required
        - `damage_made` integer, required
        - `damage_received` integer, required
        - `economy` MatchesV2DataPlayerEconomy, required
          - `loadout_value` MatchesV2DataPlayerEconomyValue, required
            - `average` number, float, required
            - `overall` integer, required
          - `spent` MatchesV2DataPlayerEconomyValue, required
            - `average` number, float, required
            - `overall` integer, required
        - `level` integer, required
        - `name` string, required
        - `party_id` string, required
        - `platform` MatchesV2DataPlatform, required
          - `os` MatchesV2DataPlatformOs, required
            - `name` string, required
            - `version` string, required
          - `type` string, required
        - `player_card` string, required
        - `player_title` string, required
        - `puuid` string, required
        - `session_playtime` MatchesV2DataPlayerSessionPlaytime, required
          - `milliseconds` integer, required
          - `minutes` integer, required
          - `seconds` integer, required
        - `stats` MatchesV2DataPlayerStats, required
          - `assists` integer, required
          - `bodyshots` integer, required
          - `deaths` integer, required
          - `headshots` integer, required
          - `kills` integer, required
          - `legshots` integer, required
          - `score` integer, required
        - `tag` string, required
        - `team` string, required
      - `blue` MatchesV2DataPlayer[], required
        - `ability_casts` MatchesV2DataPlayerAbilityCasts, required
          - `c_cast` integer, nullable
          - `e_cast` integer, nullable
          - `q_cast` integer, nullable
          - `x_cast` integer, nullable
        - `assets` MatchesV2DataPlayerAssets, required
          - `agent` MatchesV2DataPlayerAssetsAgent, required
            - `bust` string, required
            - `full` string, required
            - `killfeed` string, required
            - `small` string, required
          - `card` MatchesV2DataPlayerAssetsCard, required
            - `large` string, required
            - `small` string, required
            - `wide` string, required
        - `behavior` MatchesV2DataPlayerBehavior, required
          - `afk_rounds` number, float, required
          - `friendly_fire` MatchesV2DataPlayerBehaviorFriendlyFire, required
            - `incoming` number, float, nullable
            - `outgoing` number, float, nullable
          - `rounds_in_spawn` number, float, nullable
        - `character` string, nullable
        - `currenttier` integer, required
        - `currenttier_patched` string, required
        - `damage_made` integer, required
        - `damage_received` integer, required
        - `economy` MatchesV2DataPlayerEconomy, required
          - `loadout_value` MatchesV2DataPlayerEconomyValue, required
            - `average` number, float, required
            - `overall` integer, required
          - `spent` MatchesV2DataPlayerEconomyValue, required
            - `average` number, float, required
            - `overall` integer, required
        - `level` integer, required
        - `name` string, required
        - `party_id` string, required
        - `platform` MatchesV2DataPlatform, required
          - `os` MatchesV2DataPlatformOs, required
            - `name` string, required
            - `version` string, required
          - `type` string, required
        - `player_card` string, required
        - `player_title` string, required
        - `puuid` string, required
        - `session_playtime` MatchesV2DataPlayerSessionPlaytime, required
          - `milliseconds` integer, required
          - `minutes` integer, required
          - `seconds` integer, required
        - `stats` MatchesV2DataPlayerStats, required
          - `assists` integer, required
          - `bodyshots` integer, required
          - `deaths` integer, required
          - `headshots` integer, required
          - `kills` integer, required
          - `legshots` integer, required
          - `score` integer, required
        - `tag` string, required
        - `team` string, required
      - `red` MatchesV2DataPlayer[], required
        - `ability_casts` MatchesV2DataPlayerAbilityCasts, required
          - `c_cast` integer, nullable
          - `e_cast` integer, nullable
          - `q_cast` integer, nullable
          - `x_cast` integer, nullable
        - `assets` MatchesV2DataPlayerAssets, required
          - `agent` MatchesV2DataPlayerAssetsAgent, required
            - `bust` string, required
            - `full` string, required
            - `killfeed` string, required
            - `small` string, required
          - `card` MatchesV2DataPlayerAssetsCard, required
            - `large` string, required
            - `small` string, required
            - `wide` string, required
        - `behavior` MatchesV2DataPlayerBehavior, required
          - `afk_rounds` number, float, required
          - `friendly_fire` MatchesV2DataPlayerBehaviorFriendlyFire, required
            - `incoming` number, float, nullable
            - `outgoing` number, float, nullable
          - `rounds_in_spawn` number, float, nullable
        - `character` string, nullable
        - `currenttier` integer, required
        - `currenttier_patched` string, required
        - `damage_made` integer, required
        - `damage_received` integer, required
        - `economy` MatchesV2DataPlayerEconomy, required
          - `loadout_value` MatchesV2DataPlayerEconomyValue, required
            - `average` number, float, required
            - `overall` integer, required
          - `spent` MatchesV2DataPlayerEconomyValue, required
            - `average` number, float, required
            - `overall` integer, required
        - `level` integer, required
        - `name` string, required
        - `party_id` string, required
        - `platform` MatchesV2DataPlatform, required
          - `os` MatchesV2DataPlatformOs, required
            - `name` string, required
            - `version` string, required
          - `type` string, required
        - `player_card` string, required
        - `player_title` string, required
        - `puuid` string, required
        - `session_playtime` MatchesV2DataPlayerSessionPlaytime, required
          - `milliseconds` integer, required
          - `minutes` integer, required
          - `seconds` integer, required
        - `stats` MatchesV2DataPlayerStats, required
          - `assists` integer, required
          - `bodyshots` integer, required
          - `deaths` integer, required
          - `headshots` integer, required
          - `kills` integer, required
          - `legshots` integer, required
          - `score` integer, required
        - `tag` string, required
        - `team` string, required
    - `rounds` MatchesV2DataRound[], required
      - `bomb_defused` boolean, required
      - `bomb_planted` boolean, required
      - `defuse_events` MatchesV2DataRoundDefuseEvents, required
        - `defuse_location` MatchesV2DataRoundEventLocation
          - `x` integer, required
          - `y` integer, required
        - `defuse_time_in_round` integer, nullable
        - `defused_by` MatchesV2DataRoundPlayer
          - `display_name` string, required
          - `puuid` string, required
          - `team` string, required
        - `player_locations_on_defuse` MatchesV2DataRoundPlayerLocationsOnEvent[], nullable
          - `location` MatchesV2DataRoundEventLocation, required
            - `x` integer, required
            - `y` integer, required
          - `player_display_name` string, required
          - `player_puuid` string, required
          - `player_team` string, required
          - `view_radians` number, float, required
      - `end_type` string, required
      - `plant_events` MatchesV2DataRoundPlantEvents, required
        - `plant_location` MatchesV2DataRoundEventLocation
          - `x` integer, required
          - `y` integer, required
        - `plant_site` string, nullable
        - `plant_time_in_round` integer, nullable
        - `planted_by` MatchesV2DataRoundPlayer
          - `display_name` string, required
          - `puuid` string, required
          - `team` string, required
        - `player_locations_on_plant` MatchesV2DataRoundPlayerLocationsOnEvent[], nullable
          - `location` MatchesV2DataRoundEventLocation, required
            - `x` integer, required
            - `y` integer, required
          - `player_display_name` string, required
          - `player_puuid` string, required
          - `player_team` string, required
          - `view_radians` number, float, required
      - `player_stats` MatchesV2DataRoundPlayerStats[], required
        - `ability_casts` MatchesV2DataRoundPlayerStatsAbilityCasts, required
          - `c_casts` integer, nullable
          - `e_casts` integer, nullable
          - `q_casts` integer, nullable
          - `x_casts` integer, nullable
        - `bodyshots` integer, required
        - `damage` integer, required
        - `damage_events` MatchesV2DataRoundPlayerStatsDamageEvents[], required
          - `bodyshots` integer, required
          - `damage` integer, required
          - `headshots` integer, required
          - `legshots` integer, required
          - `receiver_display_name` string, required
          - `receiver_puuid` string, required
          - `receiver_team` string, required
        - `economy` MatchesV2DataRoundPlayerStatsEconomy, required
          - `armor` MatchesV2DataRoundPlayerStatsEconomyEquipmentArmor, required
            - `assets` MatchesV2DataRoundPlayerStatsEconomyEquipmentAssetsArmor, required
              - …
            - `id` string, nullable
            - `name` string, nullable
          - `loadout_value` integer, required
          - `remaining` integer, required
          - `spent` integer, required
          - `weapon` MatchesV2DataRoundPlayerStatsEconomyEquipmentWeapon, required
            - `assets` MatchesV2DataRoundPlayerStatsEconomyEquipmentAssets, required
              - …
            - `id` string, nullable
            - `name` string, nullable
        - `headshots` integer, required
        - `kill_events` MatchesV2DataRoundPlayerStatsKillEvents[], required
          - `assistants` MatchesV2DataRoundPlayerStatsKillEventsAssistants[], required
            - `assistant_display_name` string, required
            - `assistant_puuid` string, required
            - `assistant_team` string, required
          - `damage_weapon_assets` MatchesV2DataRoundPlayerStatsKillEventsAssets, required
            - `display_icon` string, nullable
            - `killfeed_icon` string, nullable
          - `damage_weapon_id` string, required
          - `damage_weapon_name` string, nullable
          - `kill_time_in_match` integer, required
          - `kill_time_in_round` integer, required
          - `killer_display_name` string, required
          - `killer_puuid` string, required
          - `killer_team` string, required
          - `player_locations_on_kill` MatchesV2DataRoundPlayerLocationsOnEvent[], required
            - `location` MatchesV2DataRoundEventLocation, required
              - …
            - `player_display_name` string, required
            - `player_puuid` string, required
            - `player_team` string, required
            - `view_radians` number, float, required
          - `secondary_fire_mode` boolean, required
          - `victim_death_location` MatchesV2DataRoundEventLocation, required
            - `x` integer, required
            - `y` integer, required
          - `victim_display_name` string, required
          - `victim_puuid` string, required
          - `victim_team` string, required
        - `kills` integer, required
        - `legshots` integer, required
        - `player_display_name` string, required
        - `player_puuid` string, required
        - `player_team` string, required
        - `score` integer, required
        - `stayed_in_spawn` boolean, required
        - `was_afk` boolean, required
        - `was_penalized` boolean, required
      - `winning_team` string, required
    - `teams` MatchesV2DataTeams, required
      - `blue` MatchesV2DataTeam, required
        - `has_won` boolean, nullable
        - `roster` MatchesV2DataTeamRoster
          - `customization` MatchesV2DataTeamRosterCustomization, required
            - `icon` string, required
            - `image` string, required
            - `primary_color` string, required
            - `secondary_color` string, required
            - `tertiary_color` string, required
          - `id` string, required
          - `members` string[], required
          - `name` string, required
          - `tag` string, required
        - `rounds_lost` integer, nullable
        - `rounds_won` integer, nullable
      - `red` MatchesV2DataTeam, required
        - `has_won` boolean, nullable
        - `roster` MatchesV2DataTeamRoster
          - `customization` MatchesV2DataTeamRosterCustomization, required
            - `icon` string, required
            - `image` string, required
            - `primary_color` string, required
            - `secondary_color` string, required
            - `tertiary_color` string, required
          - `id` string, required
          - `members` string[], required
          - `name` string, required
          - `tag` string, required
        - `rounds_lost` integer, nullable
        - `rounds_won` integer, nullable
  - `status` integer, required

## Other responses

- `400` — Bad Request
- `404` — Match not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/henrikdev/apis/henrikdev-api.md) · [All operations](https://skmtc.net/henrikdev/apis/henrikdev-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/henrikdev/henrikdev-api/versions/d0e83068dbeb/schema)
