Skip to main content
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

MethodPathDescription
GET/v1/competitivetiersReturns 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

​
User-Agent
string
required
Identifies your application. Format: AppName/Version (+URL).
​
language
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)"

​
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": "ランクなし",
          "division": "ECompetitiveDivision::UNRANKED",
          "divisionName": "ランクなし",
          "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

​
uuid
string
required
The UUID of the competitive tier set to retrieve.
​
User-Agent
string
required
Identifies your application. Format: AppName/Version (+URL).
​
language
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

​
uuid
string
required
Unique identifier for this competitive tier set.
​
assetObjectName
string
Asset object name for the competitive tier table (used in asset path resolution).
​
tiers
object[]
Ordered list of all ranks within this tier set, from Unranked (0) to Radiant.
​
assetPath
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.