---
title: "Get all agent mastery by PUUID (v1)"
method: GET
path: "/valorant/v1/by-puuid/agent-mastery/{affinity}/{platform}/{puuid}"
tags: ["valorant"]
---

# Get all agent mastery by PUUID (v1)

`GET /valorant/v1/by-puuid/agent-mastery/{affinity}/{platform}/{puuid}`

## Request

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

Modules are null when not included by Riot; use the single-agent endpoint for modules. Unknown metadata names and omitted levels are null. Short and long levels retain Riot's source semantics.

## Path parameters

- `affinity` 'na' | 'eu' | 'ap' | 'kr' | 'br' | 'latam', required: Valorant affinity. Inputs are case-insensitive.
- `platform` 'pc' | 'console', required: Public Valorant platform. Inputs are case-insensitive; individual console brands are not accepted.
- `puuid` string, required

## Response `200`

Mastery retrieved successfully

- AgentMasteryV1Response
  - `data` AgentMasteryV1Data, required
    - `account` AgentMasteryV1Account, required
      - `name` string, required
      - `puuid` string, required
      - `tag` string, required
    - `agents` AgentMasteryV1Agent[], required
      - `agent` AgentMasteryV1Reference, required
        - `id` string, required
        - `name` string, nullable
      - `customization` AgentMasteryV1Customization, required
        - `background` AgentMasteryV1Reference
          - `id` string, required
          - `name` string, nullable
        - `border` AgentMasteryV1Reference
          - `id` string, required
          - `name` string, nullable
        - `clip` AgentMasteryV1Reference
          - `id` string, required
          - `name` string, nullable
        - `hype` AgentMasteryV1Reference
          - `id` string, required
          - `name` string, nullable
      - `flourish` AgentMasteryV1Flourish, required
        - `long_level` integer, nullable
        - `short_level` integer, nullable
      - `modules` AgentMasteryV1Module[], nullable
        - `id` string, nullable
        - `name` string, nullable
        - `stat` AgentMasteryV1Reference, required
          - `id` string, required
          - `name` string, nullable
        - `value` number, double, required
      - `tracks` AgentMasteryV1Track[], required
        - `id` string, required
        - `level` integer, nullable
        - `name` string, nullable
  - `status` integer, required

## Other responses

- `400`: Invalid region, platform or UUID
- `404`: Account not found
- `500`: Unable to fetch or parse mastery

## Changes

- **2026-11-03** `a00021374a3e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/henrikdev/apis/henrikdev-api/changes/valorant/v1/by-puuid/agent-mastery/:affinity/:platform/: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)