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

# Get stored matches by PUUID (v1)

`GET /valorant/v1/by-puuid/stored-matches/{affinity}/{puuid}`

## Request

- Base URL: `https://api.henrikdev.xyz`
- URL: `https://api.henrikdev.xyz/valorant/v1/by-puuid/stored-matches/{affinity}/{puuid}`
- Auth: one of:
  - API key in header `Authorization`
  - API key in query parameter `api_key`

## Path parameters

- `affinity` 'na' | 'eu' | 'ap' | 'kr' | 'br' | 'latam', required: Valorant affinity. Inputs are case-insensitive.
- `puuid` string, uuid, required

## Query parameters

- `mode` string
- `queue` string
- `map` string
- `size` integer
- `page` integer

## Response `200`

Stored match history retrieved successfully

- StoredMatchesResponse
  - `data` StoredMatch[], required
    - `meta` StoredMatchMeta, required
      - `cluster` string, nullable
      - `id` string, required
      - `map` StoredMatchMetaMap, required
        - `id` string, required
        - `name` string, required
      - `mode` string, required
      - `region` string, required
      - `season` StoredMatchMetaSeason, required
        - `id` string, required
        - `short` string, required
      - `started_at` string, required
      - `version` string, required
    - `stats` StoredMatchStats, required
      - `assists` integer, required
      - `character` StoredMatchStatsCharacter, required
        - `id` string, required
        - `name` string, required
      - `damage` StoredMatchStatsDamage, required
        - `made` integer, required
        - `received` integer, required
      - `deaths` integer, required
      - `kills` integer, required
      - `level` integer, required
      - `name` string, nullable
      - `puuid` string, required
      - `score` integer, required
      - `shots` StoredMatchStatsShots, required
        - `body` integer, required
        - `head` integer, required
        - `leg` integer, required
      - `tag` string, nullable
      - `team` string, required
      - `tier` integer, required
    - `teams` StoredMatchTeam, required
      - `blue` integer, required
      - `red` integer, required
  - `results` Pagination, required
    - `after` integer, required
    - `before` integer, required
    - `returned` integer, required
    - `total` integer, required
  - `status` integer, required

## Other responses

- `400`: Bad Request
- `404`: Account not found
- `500`: Internal Server Error

## Changes

- **2026-11-03** `a00021374a3e`: 2 breaking, 2 warning, 8 info
  - the `path` request parameter `affinity` was restricted to a list of enum values
  - for the `path` request parameter `puuid`, the format changed from no format to `uuid`
  - for the `query` request parameter `size`, the max was set to `2147483647.00`
  - for the `query` request parameter `size`, the min was set to `1.00`
  - …8 more

[Operation history](https://skmtc.dev/henrikdev/apis/henrikdev-api/changes/valorant/v1/by-puuid/stored-matches/:affinity/:puuid/get.md)

---

[API](https://skmtc.dev/henrikdev/apis/henrikdev-api.md) - [All operations](https://skmtc.dev/henrikdev/apis/henrikdev-api/llms.txt) - [OpenAPI document](https://skmtc.dev/henrikdev/apis/henrikdev-api/revisions/a00021374a3e?raw)