---
title: "Get live Premier team by ID (v2)"
method: GET
path: "/valorant/v2/premier/teams/{affinity}/{id}"
tags: ["valorant"]
---

# Get live Premier team by ID (v2)

`GET /valorant/v2/premier/teams/{affinity}/{id}`

## Request

- Base URL: `https://api.henrikdev.xyz`
- URL: `https://api.henrikdev.xyz/valorant/v2/premier/teams/{affinity}/{id}`
- Auth: one of:
  - API key in header `Authorization`
  - API key in query parameter `api_key`

Fetches directly from Riot without caching. Includes the current season and season summaries, member roles and join dates. Season names are resolved from cached metadata and are null when unavailable. The seasons list may also include the current season and is sorted by ID, not chronologically. Dates are UTC RFC 3339. Leaderboard ranks and match history are not included.

## Path parameters

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

## Response `200`

Premier team retrieved successfully

- PremierTeamV2Response
  - `data` PremierTeamV2ResponseData, required
    - `created_at` string, required
    - `current_season` PremierTeamV2Season, required
      - `crest` string, required
      - `enrolled` boolean, required
      - `has_earned_prestige` boolean, required
      - `has_earned_promotion_for_next_season` boolean, required
      - `id` string, required
      - `name` string, nullable
      - `placement` PremierTeamV2Placement, required
        - `conference` string, required
        - `division` integer, required
        - `is_provisional` boolean, required
        - `points` integer, required
      - `promotion_applied` boolean, required
      - `stats` PremierTeamV2Stats, required
        - `losses` integer, required
        - `matches` integer, required
        - `rounds` PremierTeamV2Rounds, required
          - `lost` integer, required
          - `won` integer, required
        - `wins` integer, required
    - `customization` PremierTeamV1ResponseDataCustomization, required
      - `icon` string, required
      - `image` string, required
      - `primary` string, required
      - `secondary` string, required
      - `tertiary` string, required
    - `id` string, required
    - `member` PremierTeamV2Member[], required
      - `joined_at` string, required
      - `puuid` string, required
      - `role` PremierTeamV2Role, required
        - `id` integer, required
        - `name` string, required
    - `name` string, required
    - `seasons` PremierTeamV2Season[], required
      - `crest` string, required
      - `enrolled` boolean, required
      - `has_earned_prestige` boolean, required
      - `has_earned_promotion_for_next_season` boolean, required
      - `id` string, required
      - `name` string, nullable
      - `placement` PremierTeamV2Placement, required
        - `conference` string, required
        - `division` integer, required
        - `is_provisional` boolean, required
        - `points` integer, required
      - `promotion_applied` boolean, required
      - `stats` PremierTeamV2Stats, required
        - `losses` integer, required
        - `matches` integer, required
        - `rounds` PremierTeamV2Rounds, required
          - `lost` integer, required
          - `won` integer, required
        - `wins` integer, required
    - `tag` string, required
  - `status` integer, required

## Other responses

- `400`: Invalid region or UUID
- `404`: Team not found
- `500`: Failed to fetch or parse Riot data

## Changes

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

[Operation history](https://skmtc.dev/henrikdev/apis/henrikdev-api/changes/valorant/v2/premier/teams/:affinity/:id/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)
