Premier

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

PreviousMMR NextQueue Status

Last updated 7 months ago

Get details about a premier team

get

/valorant/v1/premier/{team_name}//{team_tag}

Authorizations

Path parameters

team_namestringrequired

team_tagstringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.henrikdev.xyz/valorant/v1/premier/{team_name}/{team_tag}' \
  --header 'Authorization: YOUR_API_KEY'

200

400

403

404

408

410

429

501

503

{
  "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"
      }
    ]
  }
}

Premier Team Data

Get match history of a premier team

get

/valorant/v1/premier/{team_name}//{team_tag}/history

Authorizations

Path parameters

team_namestringrequired

team_tagstringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.henrikdev.xyz/valorant/v1/premier/{team_name}/{team_tag}/history' \
  --header 'Authorization: YOUR_API_KEY'

200

400

403

404

408

410

429

501

503

{
  "status": 1,
  "data": {
    "league_matches": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "points_before": 1,
        "points_after": 1,
        "started_at": "2025-02-22T10:40:18.047Z"
      }
    ]
  }
}

Premier Team History Data

Get details about a premier team

get

/valorant/v1/premier/{team_id}

Authorizations

Path parameters

team_idstring · uuidrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.henrikdev.xyz/valorant/v1/premier/{team_id}' \
  --header 'Authorization: YOUR_API_KEY'

200

400

403

404

408

410

429

501

503

{
  "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"
      }
    ]
  }
}

Premier Team Data

Get match history of a premier team

get

/valorant/v1/premier/{team_id}/history

Authorizations

Path parameters

team_idstring · uuidrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.henrikdev.xyz/valorant/v1/premier/{team_id}/history' \
  --header 'Authorization: YOUR_API_KEY'

200

400

403

404

408

410

429

501

503

{
  "status": 1,
  "data": {
    "league_matches": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "points_before": 1,
        "points_after": 1,
        "started_at": "2025-02-22T10:40:18.047Z"
      }
    ]
  }
}

Premier Team History Data

Search for current active premier teams

get

/valorant/v1/premier/search

Authorizations

Query parameters

namestring

tagstring

divisionnumber · min: 1 · max: 20

conferencestring · enum

Options: EU_CENTRAL_EAST, EU_WEST, EU_MIDDLE_EAST, EU_TURKEY, NA_US_EAST, NA_US_WEST, LATAM_NORTH, LATAM_SOUTH, BR_BRAZIL, KR_KOREA, AP_ASIA, AP_JAPAN, AP_OCEANIA, AP_SOUTH_ASIA

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.henrikdev.xyz/valorant/v1/premier/search' \
  --header 'Authorization: YOUR_API_KEY'

200

400

403

404

408

410

429

501

503

{
  "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"
      }
    }
  ]
}

Partial Premier Team Data

Get a list of all premier conferences

get

/valorant/v1/premier/conferences

Authorizations

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.henrikdev.xyz/valorant/v1/premier/conferences' \
  --header 'Authorization: YOUR_API_KEY'

200

400

403

404

408

410

429

501

503

{
  "status": 1,
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "affinity": "eu",
      "region": "eu",
      "timezone": "text",
      "name": "EU_CENTRAL_EAST",
      "icon": "text",
      "pods": [
        {
          "pod": "text",
          "name": "text"
        }
      ]
    }
  ]
}

Conference Data

Get a list of all premier seasons

get

/valorant/v1/premier/seasons/{region}

Authorizations

Path parameters

regionstring · enumrequired

Options: eu, na, latam, br, ap, kr

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.henrikdev.xyz/valorant/v1/premier/seasons/{region}' \
  --header 'Authorization: YOUR_API_KEY'

200

400

403

404

408

410

429

501

503

{
  "status": 1,
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "championship_event_id": "123e4567-e89b-12d3-a456-426614174000",
      "championship_points_required": 1,
      "starts_at": "2025-02-22T10:40:18.047Z",
      "ends_at": "2025-02-22T10:40:18.047Z",
      "enrollment_starts_at": "2025-02-22T10:40:18.047Z",
      "enrollment_ends_at": "2025-02-22T10:40:18.047Z",
      "events": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "type": "LEAGUE",
          "starts_at": "2025-02-22T10:40:18.047Z",
          "ends_at": "2025-02-22T10:40:18.047Z",
          "map_selection": {
            "type": "RANDOM",
            "maps": [
              {
                "name": "Ascent",
                "id": "123e4567-e89b-12d3-a456-426614174000"
              }
            ]
          },
          "points_required_to_participate": 1,
          "conference_schedules": [
            {
              "conference": "EU_CENTRAL_EAST",
              "starts_at": "2025-02-22T10:40:18.047Z",
              "ends_at": "2025-02-22T10:40:18.047Z"
            }
          ]
        }
      ],
      "scheduled_events": [
        {
          "event_id": "123e4567-e89b-12d3-a456-426614174000",
          "conference": "EU_CENTRAL_EAST",
          "starts_at": "2025-02-22T10:40:18.047Z",
          "ends_at": "2025-02-22T10:40:18.047Z"
        }
      ]
    }
  ]
}

Permier Seasons Data

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

get

/valorant/v1/premier/leaderboard/{region}

Authorizations

Path parameters

regionstring · enumrequired

Options: eu, na, latam, br, ap, kr

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.henrikdev.xyz/valorant/v1/premier/leaderboard/{region}' \
  --header 'Authorization: YOUR_API_KEY'

200

400

403

404

408

410

429

501

503

{
  "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"
      }
    }
  ]
}

Partial Premier Team Data

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

get

/valorant/v1/premier/leaderboard/{region}//{conference}

Authorizations

Path parameters

regionstring · enumrequired

Options: eu, na, latam, br, ap, kr

conferencestring · enumrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.henrikdev.xyz/valorant/v1/premier/leaderboard/{region}/{conference}' \
  --header 'Authorization: YOUR_API_KEY'

200

400

403

404

408

410

429

501

503

{
  "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"
      }
    }
  ]
}

Partial Premier Team Data

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

get

/valorant/v1/premier/leaderboard/{region}//{conference}//{division}

Authorizations

Path parameters

regionstring · enumrequired

Options: eu, na, latam, br, ap, kr

conferencestring · enumrequired

divisionnumber · min: 1 · max: 20required

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.henrikdev.xyz/valorant/v1/premier/leaderboard/{region}/{conference}/{division}' \
  --header 'Authorization: YOUR_API_KEY'

200

400

403

404

408

410

429

501

503

{
  "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"
      }
    }
  ]
}

Partial Premier Team Data