HenrikDev API
  • Hello and welcome :D
  • Authentication & Authorization
  • VALORANT
    • General
    • Changes
      • v4.2.0
      • v4.1.0
      • v4.0.1
      • v4.0.0
    • Error Codes
    • API Reference
      • Accounts
      • Content
      • Crosshair
      • Esports
      • Leaderboard
      • Matchlist
      • Match
      • MMR History
      • MMR
      • Premier
      • Queue Status
      • Raw
      • Status
      • Stored Data
      • Store (no daily stores)
      • Version
      • Website
Powered by GitBook
On this page
  1. VALORANT
  2. API Reference

Premier

PreviousMMRNextQueue Status

Last updated 10 months ago

Get leaderboard, search for teams, match history, metadata, seasons and conferences

get

Get details about a premier team

Authorizations
Path parameters
team_namestringRequired
team_tagstringRequired
Responses
200
Premier Team Data
application/json
400
Request error by the client (missing query for example)
application/json
403
Forbidden to connect to the Riot API (mainly maintenance reasons on riot side like patches) or to the HenrikDev API itself because of bot prevention for example
application/json
404
The entity was not found (player/match/general data)
application/json
408
Timeout while fetching riot data
application/json
410
Endpoint is deprecated
application/json
429
Rate limit reached (can be global API limit which affects all users or just you, when the "x-ratelimit-remaining" header is 0 then it's a personal limit)
application/json
501
API Version not implemented, check the requested endpoint url
application/json
503
Riot API seems to be down, API unable to connect
application/json
get
GET /valorant/v1/premier/{team_name}/{team_tag} HTTP/1.1
Host: api.henrikdev.xyz
Authorization: YOUR_API_KEY
Accept: */*
{
  "status": 1,
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "tag": "text",
    "enrolled": true,
    "stats": {
      "wins": 1,
      "matches": 1,
      "losses": 1
    },
    "placement": {
      "points": 1,
      "conference": "text",
      "division": 1,
      "place": 1
    },
    "customization": {
      "icon": "text",
      "image": "text",
      "primary": "text",
      "secondary": "text",
      "tertiary": "text"
    },
    "member": [
      {
        "puuid": "text",
        "name": "text",
        "tag": "text"
      }
    ]
  }
}
get

Get match history of a premier team

Authorizations
Path parameters
team_namestringRequired
team_tagstringRequired
Responses
200
Premier Team History Data
application/json
400
Request error by the client (missing query for example)
application/json
403
Forbidden to connect to the Riot API (mainly maintenance reasons on riot side like patches) or to the HenrikDev API itself because of bot prevention for example
application/json
404
The entity was not found (player/match/general data)
application/json
408
Timeout while fetching riot data
application/json
410
Endpoint is deprecated
application/json
429
Rate limit reached (can be global API limit which affects all users or just you, when the "x-ratelimit-remaining" header is 0 then it's a personal limit)
application/json
501
API Version not implemented, check the requested endpoint url
application/json
503
Riot API seems to be down, API unable to connect
application/json
get
GET /valorant/v1/premier/{team_name}/{team_tag}/history HTTP/1.1
Host: api.henrikdev.xyz
Authorization: YOUR_API_KEY
Accept: */*
{
  "status": 1,
  "data": {
    "league_matches": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "points_before": 1,
        "points_after": 1,
        "started_at": "2025-05-12T03:06:57.938Z"
      }
    ]
  }
}
get

Get details about a premier team

Authorizations
Path parameters
team_idstring · uuidRequired
Responses
200
Premier Team Data
application/json
400
Request error by the client (missing query for example)
application/json
403
Forbidden to connect to the Riot API (mainly maintenance reasons on riot side like patches) or to the HenrikDev API itself because of bot prevention for example
application/json
404
The entity was not found (player/match/general data)
application/json
408
Timeout while fetching riot data
application/json
410
Endpoint is deprecated
application/json
429
Rate limit reached (can be global API limit which affects all users or just you, when the "x-ratelimit-remaining" header is 0 then it's a personal limit)
application/json
501
API Version not implemented, check the requested endpoint url
application/json
503
Riot API seems to be down, API unable to connect
application/json
get
GET /valorant/v1/premier/{team_id} HTTP/1.1
Host: api.henrikdev.xyz
Authorization: YOUR_API_KEY
Accept: */*
{
  "status": 1,
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "tag": "text",
    "enrolled": true,
    "stats": {
      "wins": 1,
      "matches": 1,
      "losses": 1
    },
    "placement": {
      "points": 1,
      "conference": "text",
      "division": 1,
      "place": 1
    },
    "customization": {
      "icon": "text",
      "image": "text",
      "primary": "text",
      "secondary": "text",
      "tertiary": "text"
    },
    "member": [
      {
        "puuid": "text",
        "name": "text",
        "tag": "text"
      }
    ]
  }
}
get

Get match history of a premier team

Authorizations
Path parameters
team_idstring · uuidRequired
Responses
200
Premier Team History Data
application/json
400
Request error by the client (missing query for example)
application/json
403
Forbidden to connect to the Riot API (mainly maintenance reasons on riot side like patches) or to the HenrikDev API itself because of bot prevention for example
application/json
404
The entity was not found (player/match/general data)
application/json
408
Timeout while fetching riot data
application/json
410
Endpoint is deprecated
application/json
429
Rate limit reached (can be global API limit which affects all users or just you, when the "x-ratelimit-remaining" header is 0 then it's a personal limit)
application/json
501
API Version not implemented, check the requested endpoint url
application/json
503
Riot API seems to be down, API unable to connect
application/json
get
GET /valorant/v1/premier/{team_id}/history HTTP/1.1
Host: api.henrikdev.xyz
Authorization: YOUR_API_KEY
Accept: */*
{
  "status": 1,
  "data": {
    "league_matches": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "points_before": 1,
        "points_after": 1,
        "started_at": "2025-05-12T03:06:57.938Z"
      }
    ]
  }
}
get

Search for current active premier teams

Authorizations
Query parameters
namestringOptional
tagstringOptional
divisionnumber · min: 1 · max: 20Optional
conferencestring · enumOptionalPossible values:
Responses
200
Partial Premier Team Data
application/json
400
Request error by the client (missing query for example)
application/json
403
Forbidden to connect to the Riot API (mainly maintenance reasons on riot side like patches) or to the HenrikDev API itself because of bot prevention for example
application/json
404
The entity was not found (player/match/general data)
application/json
408
Timeout while fetching riot data
application/json
410
Endpoint is deprecated
application/json
429
Rate limit reached (can be global API limit which affects all users or just you, when the "x-ratelimit-remaining" header is 0 then it's a personal limit)
application/json
501
API Version not implemented, check the requested endpoint url
application/json
503
Riot API seems to be down, API unable to connect
application/json
get
GET /valorant/v1/premier/search HTTP/1.1
Host: api.henrikdev.xyz
Authorization: YOUR_API_KEY
Accept: */*
{
  "status": 1,
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "tag": "text",
      "conference": "EU_CENTRAL_EAST",
      "division": 1,
      "affinity": "eu",
      "region": "eu",
      "losses": 1,
      "wins": 1,
      "score": 1,
      "ranking": 1,
      "customization": {
        "icon": "text",
        "image": "text",
        "primary": "text",
        "secondary": "text",
        "tertiary": "text"
      }
    }
  ]
}
get

Get a list of all premier conferences

Authorizations
Responses
200
Conference Data
application/json
400
Request error by the client (missing query for example)
application/json
403
Forbidden to connect to the Riot API (mainly maintenance reasons on riot side like patches) or to the HenrikDev API itself because of bot prevention for example
application/json
404
The entity was not found (player/match/general data)
application/json
408
Timeout while fetching riot data
application/json
410
Endpoint is deprecated
application/json
429
Rate limit reached (can be global API limit which affects all users or just you, when the "x-ratelimit-remaining" header is 0 then it's a personal limit)
application/json
501
API Version not implemented, check the requested endpoint url
application/json
503
Riot API seems to be down, API unable to connect
application/json
get
GET /valorant/v1/premier/conferences HTTP/1.1
Host: api.henrikdev.xyz
Authorization: YOUR_API_KEY
Accept: */*
{
  "status": 1,
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "affinity": "eu",
      "pods": [
        {
          "pod": "text",
          "name": "text"
        }
      ],
      "region": "eu",
      "timezone": "text",
      "name": "EU_CENTRAL_EAST",
      "icon": "text"
    }
  ]
}
get

Get a list of all premier seasons

Authorizations
Path parameters
regionstring · enumRequiredPossible values:
Responses
200
Permier Seasons Data
application/json
400
Request error by the client (missing query for example)
application/json
403
Forbidden to connect to the Riot API (mainly maintenance reasons on riot side like patches) or to the HenrikDev API itself because of bot prevention for example
application/json
404
The entity was not found (player/match/general data)
application/json
408
Timeout while fetching riot data
application/json
410
Endpoint is deprecated
application/json
429
Rate limit reached (can be global API limit which affects all users or just you, when the "x-ratelimit-remaining" header is 0 then it's a personal limit)
application/json
501
API Version not implemented, check the requested endpoint url
application/json
503
Riot API seems to be down, API unable to connect
application/json
get
GET /valorant/v1/premier/seasons/{region} HTTP/1.1
Host: api.henrikdev.xyz
Authorization: YOUR_API_KEY
Accept: */*
{
  "status": 1,
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "championship_event_id": "123e4567-e89b-12d3-a456-426614174000",
      "championship_points_required": 1,
      "starts_at": "2025-05-12T03:06:57.938Z",
      "ends_at": "2025-05-12T03:06:57.938Z",
      "enrollment_starts_at": "2025-05-12T03:06:57.938Z",
      "enrollment_ends_at": "2025-05-12T03:06:57.938Z",
      "events": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "type": "LEAGUE",
          "starts_at": "2025-05-12T03:06:57.938Z",
          "ends_at": "2025-05-12T03:06:57.938Z",
          "conference_schedules": [
            {
              "conference": "EU_CENTRAL_EAST",
              "starts_at": "2025-05-12T03:06:57.938Z",
              "ends_at": "2025-05-12T03:06:57.938Z"
            }
          ],
          "map_selection": {
            "type": "RANDOM",
            "maps": [
              {
                "name": "Ascent",
                "id": "123e4567-e89b-12d3-a456-426614174000"
              }
            ]
          },
          "points_required_to_participate": 1
        }
      ],
      "scheduled_events": [
        {
          "event_id": "123e4567-e89b-12d3-a456-426614174000",
          "conference": "EU_CENTRAL_EAST",
          "starts_at": "2025-05-12T03:06:57.938Z",
          "ends_at": "2025-05-12T03:06:57.938Z"
        }
      ]
    }
  ]
}
get

Get a combined leaderboard in the affinity, sorted by div and ranking

Authorizations
Path parameters
regionstring · enumRequiredPossible values:
Responses
200
Partial Premier Team Data
application/json
400
Request error by the client (missing query for example)
application/json
403
Forbidden to connect to the Riot API (mainly maintenance reasons on riot side like patches) or to the HenrikDev API itself because of bot prevention for example
application/json
404
The entity was not found (player/match/general data)
application/json
408
Timeout while fetching riot data
application/json
410
Endpoint is deprecated
application/json
429
Rate limit reached (can be global API limit which affects all users or just you, when the "x-ratelimit-remaining" header is 0 then it's a personal limit)
application/json
501
API Version not implemented, check the requested endpoint url
application/json
503
Riot API seems to be down, API unable to connect
application/json
get
GET /valorant/v1/premier/leaderboard/{region} HTTP/1.1
Host: api.henrikdev.xyz
Authorization: YOUR_API_KEY
Accept: */*
{
  "status": 1,
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "tag": "text",
      "conference": "EU_CENTRAL_EAST",
      "division": 1,
      "affinity": "eu",
      "region": "eu",
      "losses": 1,
      "wins": 1,
      "score": 1,
      "ranking": 1,
      "customization": {
        "icon": "text",
        "image": "text",
        "primary": "text",
        "secondary": "text",
        "tertiary": "text"
      }
    }
  ]
}
get

Get a combined leaderboard in the conference, sorted by div and ranking

Authorizations
Path parameters
regionstring · enumRequiredPossible values:
conferencestring · enumRequiredPossible values:
Responses
200
Partial Premier Team Data
application/json
400
Request error by the client (missing query for example)
application/json
403
Forbidden to connect to the Riot API (mainly maintenance reasons on riot side like patches) or to the HenrikDev API itself because of bot prevention for example
application/json
404
The entity was not found (player/match/general data)
application/json
408
Timeout while fetching riot data
application/json
410
Endpoint is deprecated
application/json
429
Rate limit reached (can be global API limit which affects all users or just you, when the "x-ratelimit-remaining" header is 0 then it's a personal limit)
application/json
501
API Version not implemented, check the requested endpoint url
application/json
503
Riot API seems to be down, API unable to connect
application/json
get
GET /valorant/v1/premier/leaderboard/{region}/{conference} HTTP/1.1
Host: api.henrikdev.xyz
Authorization: YOUR_API_KEY
Accept: */*
{
  "status": 1,
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "tag": "text",
      "conference": "EU_CENTRAL_EAST",
      "division": 1,
      "affinity": "eu",
      "region": "eu",
      "losses": 1,
      "wins": 1,
      "score": 1,
      "ranking": 1,
      "customization": {
        "icon": "text",
        "image": "text",
        "primary": "text",
        "secondary": "text",
        "tertiary": "text"
      }
    }
  ]
}
get

Get a combined leaderboard in the conference, sorted by ranking in that div

Authorizations
Path parameters
regionstring · enumRequiredPossible values:
conferencestring · enumRequiredPossible values:
divisionnumber · min: 1 · max: 20Required
Responses
200
Partial Premier Team Data
application/json
400
Request error by the client (missing query for example)
application/json
403
Forbidden to connect to the Riot API (mainly maintenance reasons on riot side like patches) or to the HenrikDev API itself because of bot prevention for example
application/json
404
The entity was not found (player/match/general data)
application/json
408
Timeout while fetching riot data
application/json
410
Endpoint is deprecated
application/json
429
Rate limit reached (can be global API limit which affects all users or just you, when the "x-ratelimit-remaining" header is 0 then it's a personal limit)
application/json
501
API Version not implemented, check the requested endpoint url
application/json
503
Riot API seems to be down, API unable to connect
application/json
get
GET /valorant/v1/premier/leaderboard/{region}/{conference}/{division} HTTP/1.1
Host: api.henrikdev.xyz
Authorization: YOUR_API_KEY
Accept: */*
{
  "status": 1,
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "tag": "text",
      "conference": "EU_CENTRAL_EAST",
      "division": 1,
      "affinity": "eu",
      "region": "eu",
      "losses": 1,
      "wins": 1,
      "score": 1,
      "ranking": 1,
      "customization": {
        "icon": "text",
        "image": "text",
        "primary": "text",
        "secondary": "text",
        "tertiary": "text"
      }
    }
  ]
}
  • GET/valorant/v1/premier/{team_name}/{team_tag}
  • GET/valorant/v1/premier/{team_name}/{team_tag}/history
  • GET/valorant/v1/premier/{team_id}
  • GET/valorant/v1/premier/{team_id}/history
  • GET/valorant/v1/premier/search
  • GET/valorant/v1/premier/conferences
  • GET/valorant/v1/premier/seasons/{region}
  • GET/valorant/v1/premier/leaderboard/{region}
  • GET/valorant/v1/premier/leaderboard/{region}/{conference}
  • GET/valorant/v1/premier/leaderboard/{region}/{conference}/{division}