---
title: "Get matches by PUUID (v4)"
method: GET
path: "/valorant/v4/by-puuid/matches/{affinity}/{platform}/{puuid}"
tags: ["valorant"]
---

# Get matches by PUUID (v4)

`GET /valorant/v4/by-puuid/matches/{affinity}/{platform}/{puuid}`

## Path parameters

- `affinity` string, required
- `platform` string, required
- `puuid` string, required

## Query parameters

- `mode` string
- `map` string
- `size` integer
- `start` integer

## Response `200`

Match history retrieved successfully

- MatchesV4HistoryResponse
  - `data` MatchesV4Data[], required
    - `coaches` MatchesV4DataCoach[], required
      - `puuid` string, required
      - `team_id` string, required
    - `kills` MatchesV4DataKill[], required
      - `assistants` MatchesV4DataRoundPlayer[], required
        - `name` string, required
        - `puuid` string, required
        - `tag` string, required
        - `team` string, required
      - `killer` MatchesV4DataRoundPlayer, required
        - `name` string, required
        - `puuid` string, required
        - `tag` string, required
        - `team` string, required
      - `location` MatchesV4DataRoundLocation, required
        - `x` integer, required
        - `y` integer, required
      - `player_locations` MatchesV4DataRoundPlayerLocations[], required
        - `location` MatchesV4DataRoundLocation, required
          - `x` integer, required
          - `y` integer, required
        - `player` MatchesV4DataRoundPlayer, required
          - `name` string, required
          - `puuid` string, required
          - `tag` string, required
          - `team` string, required
        - `view_radians` number, float, required
      - `round` integer, required
      - `secondary_fire_mode` boolean, required
      - `time_in_match_in_ms` integer, required
      - `time_in_round_in_ms` integer, required
      - `victim` MatchesV4DataRoundPlayer, required
        - `name` string, required
        - `puuid` string, required
        - `tag` string, required
        - `team` string, required
      - `weapon` MatchesV4DataRoundPlayerStatsEconomyWeapon, required
        - `id` string, nullable
        - `name` string, nullable
        - `type` string, nullable
    - `metadata` MatchesV4DataMetadata, required
      - `cluster` string, nullable
      - `game_length_in_ms` integer, required
      - `game_version` string, required
      - `is_completed` boolean, required
      - `map` MapIdNameCombo, required
        - `id` string, required
        - `name` string, required
      - `match_id` string, required
      - `party_rr_penaltys` MatchesV4DataMetadataPartyRRPenalty[], required
        - `party_id` string, required
        - `penalty` number, float, required
      - `platform` string, required
      - `premier` unknown
      - `queue` MatchesV4DataMetadataQueue, required
        - `id` string, required
        - `mode_type` string, nullable
        - `name` string, nullable
      - `region` string, nullable
      - `season` SeasonIdShortCombo, required
        - `id` string, required
        - `short` string, required
      - `started_at` string, required
    - `observers` MatchesV4DataObserver[], required
      - `account_level` integer, required
      - `card_id` string, required
      - `name` string, required
      - `party_id` string, required
      - `puuid` string, required
      - `session_playtime_in_ms` integer, required
      - `tag` string, required
      - `title_id` string, required
    - `players` MatchesV4DataPlayer[], required
      - `ability_casts` MatchesV4DataPlayerAbilityCasts, required
        - `ability1` integer, nullable
        - `ability2` integer, nullable
        - `grenade` integer, nullable
        - `ultimate` integer, nullable
      - `account_level` integer, required
      - `agent` AgentIdNameCombo, required
        - `id` string, required
        - `name` string, required
      - `behavior` MatchesV4DataPlayerBehavior, required
        - `afk_rounds` number, float, required
        - `friendly_fire` MatchesV4DataPlayerBehaviorFriendlyFire, required
          - `incoming` number, float, required
          - `outgoing` number, float, required
        - `rounds_in_spawn` number, float, required
      - `customization` MatchesV4DataPlayerCustomization, required
        - `card` string, required
        - `preferred_level_border` string, nullable
        - `title` string, required
      - `economy` MatchesV4DataPlayerEconomy, required
        - `loadout_value` MatchesV4DataPlayerEconomyLoadoutValue, required
          - `average` number, float, required
          - `overall` integer, required
        - `spent` MatchesV4DataPlayerEconomySpent, required
          - `average` number, float, required
          - `overall` integer, required
      - `name` string, required
      - `party_id` string, required
      - `platform` string, required
      - `puuid` string, required
      - `session_playtime_in_ms` integer, required
      - `stats` MatchesV4DataPlayerStats, required
        - `assists` integer, required
        - `bodyshots` integer, required
        - `damage` MatchesV4DataPlayerStatsDamage, required
          - `dealt` integer, required
          - `received` integer, required
        - `deaths` integer, required
        - `headshots` integer, required
        - `kills` integer, required
        - `legshots` integer, required
        - `score` integer, required
      - `tag` string, required
      - `team_id` string, required
      - `tier` TierIdNameCombo, required
        - `id` integer, required
        - `name` string, required
    - `rounds` MatchesV4DataRound[], required
      - `ceremony` string, required
      - `defuse` MatchesV4DataRoundDefuse
        - `location` MatchesV4DataRoundLocation, required
          - `x` integer, required
          - `y` integer, required
        - `player` MatchesV4DataRoundPlayer, required
          - `name` string, required
          - `puuid` string, required
          - `tag` string, required
          - `team` string, required
        - `player_locations` MatchesV4DataRoundPlayerLocations[], required
          - `location` MatchesV4DataRoundLocation, required
            - `x` integer, required
            - `y` integer, required
          - `player` MatchesV4DataRoundPlayer, required
            - `name` string, required
            - `puuid` string, required
            - `tag` string, required
            - `team` string, required
          - `view_radians` number, float, required
        - `round_time_in_ms` integer, required
      - `id` integer, required
      - `plant` MatchesV4DataRoundPlant
        - `location` MatchesV4DataRoundLocation, required
          - `x` integer, required
          - `y` integer, required
        - `player` MatchesV4DataRoundPlayer, required
          - `name` string, required
          - `puuid` string, required
          - `tag` string, required
          - `team` string, required
        - `player_locations` MatchesV4DataRoundPlayerLocations[], required
          - `location` MatchesV4DataRoundLocation, required
            - `x` integer, required
            - `y` integer, required
          - `player` MatchesV4DataRoundPlayer, required
            - `name` string, required
            - `puuid` string, required
            - `tag` string, required
            - `team` string, required
          - `view_radians` number, float, required
        - `round_time_in_ms` integer, required
        - `site` string, required
      - `result` string, required
      - `stats` MatchesV4DataRoundPlayerStats[], required
        - `ability_casts` MatchesV4DataRoundPlayerStatsAbilityCasts, required
          - `ability_1` integer, nullable
          - `ability_2` integer, nullable
          - `grenade` integer, nullable
          - `ultimate` integer, nullable
        - `damage_events` MatchesV4DataRoundPlayerStatsDamageEvents[], required
          - `bodyshots` integer, required
          - `damage` integer, required
          - `headshots` integer, required
          - `legshots` integer, required
          - `player` MatchesV4DataRoundPlayer, required
            - `name` string, required
            - `puuid` string, required
            - `tag` string, required
            - `team` string, required
        - `economy` MatchesV4DataRoundPlayerStatsEconomy, required
          - `armor` MatchesV4DataRoundPlayerStatsEconomyArmor
            - `id` string, required
            - `name` string, nullable
          - `loadout_value` integer, required
          - `remaining` integer, required
          - `weapon` MatchesV4DataRoundPlayerStatsEconomyWeapon
            - `id` string, nullable
            - `name` string, nullable
            - `type` string, nullable
        - `player` MatchesV4DataRoundPlayer, required
          - `name` string, required
          - `puuid` string, required
          - `tag` string, required
          - `team` string, required
        - `received_penalty` boolean, required
        - `stats` MatchesV4DataRoundPlayerStatsStats, required
          - `bodyshots` integer, required
          - `headshots` integer, required
          - `kills` integer, required
          - `legshots` integer, required
          - `score` integer, required
        - `stayed_in_spawn` boolean, required
        - `was_afk` boolean, required
      - `winning_team` string, required
    - `teams` MatchesV4DataTeam[], required
      - `premier_roster` MatchesV4DataTeamPremierRoster
        - `customization` MatchesV4DataTeamPremierRosterCustomization, 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` MatchesV4DataTeamRounds, required
        - `lost` integer, required
        - `won` integer, required
      - `team_id` string, required
      - `won` boolean, required
  - `status` integer, required

## Other responses

- `400` — Bad Request
- `404` — Account 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)