Competitive Tiers API — GET /v1/competitivetiers

The Competitive Tiers API returns the ranked ladder definitions used across Valorant’s history. Each tier set is versioned per episode, so the data reflects how the rank system has changed over time — including tier count, names, and iconography. Within each tier set you get the full ladder from Iron to Radiant, with display names, division labels, hex color codes, and icon URLs for both the rank icon and the triangle indicators used in the end-of-match summary.

The User-Agent header is required for all requests. Use the format AppName/Version (+URL) — for example, MyApp/1.0 (+https://example.com).

Multiple tier sets exist because Riot has adjusted the competitive system between episodes. Use the Seasons API’s competitiveTiersUuid field to identify which tier set was active during a specific act.

Endpoints

Method	Path	Description
GET	`/v1/competitivetiers`	Returns all competitive tier sets
GET	`/v1/competitivetiers/{uuid}`	Returns a single tier set by UUID

GET /v1/competitivetiers

Returns an array of all competitive tier set versions.

Request parameters

string

required

Identifies your application. Format: AppName/Version (+URL).

string

default:"en-US"

Locale for localized tier display names. Example: ja-JP, es-MX.

Example request

curl --request GET \
  --url "https://astra.teamfortuna.xyz/v1/competitivetiers" \
  --header "User-Agent: MyApp/1.0 (+https://example.com)"

curl --request GET \
  --url "https://astra.teamfortuna.xyz/v1/competitivetiers?language=ja-JP" \
  --header "User-Agent: MyApp/1.0 (+https://example.com)"

Response

{
  "status": 200,
  "data": [
    {
      "uuid": "c1ba423d-25f5-30a3-8637-b516efc92670",
      "assetObjectName": "Episode1_CompetitiveTierDataTable",
      "assetPath": "ShooterGame/Content/UI/Screens/Shared/Competitive/Episode1_CompetitiveTierDataTable",
      "tiers": [
        {
          "tier": 0,
          "tierName": "UNRANKED",
          "division": "ECompetitiveDivision::UNRANKED",
          "divisionName": "UNRANKED",
          "color": "ffffffff",
          "backgroundColor": "00000000",
          "smallIcon": "https://valmedia.teamfortuna.xyz/competitivetiers/c1ba423d-25f5-30a3-8637-b516efc92670/0/smallicon.png",
          "largeIcon": "https://valmedia.teamfortuna.xyz/competitivetiers/c1ba423d-25f5-30a3-8637-b516efc92670/0/largeicon.png",
          "rankTriangleDownIcon": "https://valmedia.teamfortuna.xyz/competitivetiers/c1ba423d-25f5-30a3-8637-b516efc92670/0/ranktriangledownicon.png",
          "rankTriangleUpIcon": "https://valmedia.teamfortuna.xyz/competitivetiers/c1ba423d-25f5-30a3-8637-b516efc92670/0/ranktriangleupicon.png"
        }
      ]
    }
  ]
}

GET /v1/competitivetiers/

Returns a single competitive tier set matching the provided UUID.

Request parameters

string

required

The UUID of the competitive tier set to retrieve.

string

required

Identifies your application. Format: AppName/Version (+URL).

string

default:"en-US"

Locale for localized tier display names.

Example request

cURL

curl --request GET \
  --url "https://astra.teamfortuna.xyz/v1/competitivetiers/03702c14-f54b-f194-edd7-5faa8a8e0a72" \
  --header "User-Agent: MyApp/1.0 (+https://example.com)"

Response fields

string

required

Unique identifier for this competitive tier set.

string

Asset object name for the competitive tier table (used in asset path resolution).

object[]

Ordered list of all ranks within this tier set, from Unranked (0) to Radiant.

Show tier properties

number

Numeric tier index. Lower numbers are lower ranks; 0 is Unranked.

string

Localized tier name (e.g., "IRON 1", "PLATINUM 3", "RADIANT").

string

Internal division enum string (e.g., "ECompetitiveDivision::IRON").

string

Localized division label, typically matching the base rank name without the subdivision number.

string

8-character RGBA hex color code for the rank’s primary display color (e.g., "f2a900ff").

string

8-character RGBA hex color code for the rank’s background (e.g., "f5f0e8ff").

string

URL to the small rank icon, used in scoreboard and player card contexts.

string

URL to the large rank icon, used in profile and end-of-match screens.

string

URL to the upward triangle icon shown on rank-up screens. May be null for tiers where this is not applicable.

string

URL to the downward triangle icon shown on rank-down screens. May be null for tiers where this is not applicable.

string

Internal Unreal Engine asset path.

Color values use 8-character RGBA hex format rather than the standard 6-character RGB. Strip the last two characters (the alpha channel) if you need a plain RGB hex value for CSS.

System

Agents & Characters

Cosmetics

Weapons

Game Data

Premier

Localization

Competitive Tiers API — GET /v1/competitivetiers

Endpoints

GET /v1/competitivetiers

Request parameters

Example request

Response

GET /v1/competitivetiers/

Request parameters

Example request

Response fields

​Endpoints

​GET /v1/competitivetiers

​Request parameters

​Example request

​Response

​GET /v1/competitivetiers/

​Request parameters

​Example request

​Response fields

Endpoints

GET /v1/competitivetiers

Request parameters

Example request

Response

GET /v1/competitivetiers/

Request parameters

Example request

Response fields