> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teamfortuna.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Content Tiers API — GET /v1/contenttiers endpoints

> Retrieve all Valorant content tier definitions or a single tier by UUID. Tiers classify cosmetic rarity: Select, Deluxe, Premium, Ultra, and Exclusive.

The Content Tiers API provides the rarity classifications applied to Valorant cosmetics. These tiers — Select Edition, Deluxe Edition, Premium Edition, Ultra Edition, and Exclusive Edition — determine a skin's visual quality tier and generally correlate with its price in VP. Each tier entry includes its display name, rank number, highlight color, and display icon, which you can use to render rarity badges alongside cosmetic listings in your application.

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

## Endpoints

| Method | Path                      | Description                           |
| ------ | ------------------------- | ------------------------------------- |
| GET    | `/v1/contenttiers`        | Returns all content tier definitions  |
| GET    | `/v1/contenttiers/{uuid}` | Returns a single content tier by UUID |

***

## GET /v1/contenttiers

Returns an array of all content tier definitions.

### Request parameters

<ParamField header="User-Agent" type="string" required>
  Identifies your application. Format: `AppName/Version (+URL)`.
</ParamField>

<ParamField query="language" type="string" default="en-US">
  Locale for localized display names. Example: `fr-FR`, `ko-KR`.
</ParamField>

### Example request

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url "https://astra.teamfortuna.xyz/v1/contenttiers" \
    --header "User-Agent: MyApp/1.0 (+https://example.com)"
  ```

  ```bash cURL with language theme={null}
  curl --request GET \
    --url "https://astra.teamfortuna.xyz/v1/contenttiers?language=fr-FR" \
    --header "User-Agent: MyApp/1.0 (+https://example.com)"
  ```
</CodeGroup>

### Response

```json theme={null}
{
  "status": 200,
  "data": [
    {
      "uuid": "0cebb8be-46d7-c12a-d306-e9907bfc5a25",
      "displayName": "Édition Deluxe",
      "devName": "Deluxe",
      "rank": 1,
      "juiceCost": 60,
      "juiceValue": 20,
      "highlightColor": null,
      "displayIcon": "https://valmedia.teamfortuna.xyz/contenttiers/0cebb8be-46d7-c12a-d306-e9907bfc5a25/displayicon.png",
      "assetPath": "ShooterGame/Content/ContentTiers/Deluxe_PrimaryAsset"
    }
  ]
}
```

***

## GET /v1/contenttiers/{uuid}

Returns a single content tier definition matching the provided UUID.

### Request parameters

<ParamField path="uuid" type="string" required>
  The UUID of the content tier to retrieve.
</ParamField>

<ParamField header="User-Agent" type="string" required>
  Identifies your application. Format: `AppName/Version (+URL)`.
</ParamField>

<ParamField query="language" type="string" default="en-US">
  Locale for localized display names.
</ParamField>

### Example request

```bash cURL theme={null}
curl --request GET \
  --url "https://astra.teamfortuna.xyz/v1/contenttiers/60bca009-4182-7998-dee7-b8a2558dc369" \
  --header "User-Agent: MyApp/1.0 (+https://example.com)"
```

### Response

```json theme={null}
{
  "status": 200,
  "data": {
    "uuid": "60bca009-4182-7998-dee7-b8a2558dc369",
    "displayName": "Premium Edition",
    "devName": "Premium",
    "rank": 2,
    "juiceCost": 100,
    "juiceValue": 30,
    "highlightColor": null,
    "displayIcon": "https://valmedia.teamfortuna.xyz/contenttiers/60bca009-4182-7998-dee7-b8a2558dc369/displayicon.png",
    "assetPath": "ShooterGame/Content/ContentTiers/Premium_PrimaryAsset"
  }
}
```

***

## Response fields

<ResponseField name="uuid" type="string" required>
  Unique identifier for the content tier.
</ResponseField>

<ResponseField name="displayName" type="string" required>
  Localized display name of the rarity tier (e.g., `"Premium Edition"`, `"Ultra Edition"`).
</ResponseField>

<ResponseField name="devName" type="string">
  Short name for the tier used in asset identifiers (e.g., `"Premium"`, `"Exclusive"`).
</ResponseField>

<ResponseField name="rank" type="number">
  Numeric rank of the tier. Higher values indicate higher rarity. Use this to sort tiers from lowest to highest.
</ResponseField>

<ResponseField name="juiceValue" type="number">
  Internal value representing the content weight of this tier, used in Riot's economy calculations.
</ResponseField>

<ResponseField name="juiceCost" type="number">
  Internal cost metric associated with this tier's economy weighting.
</ResponseField>

<ResponseField name="highlightColor" type="string">
  8-character RGBA hex color code used to accent UI elements for this tier (e.g., `"0096c7ff"` for Premium Edition blue).
</ResponseField>

<ResponseField name="displayIcon" type="string">
  URL to the tier's icon, used to render rarity badges on skin listings.
</ResponseField>

<ResponseField name="assetPath" type="string">
  Internal Unreal Engine asset path.
</ResponseField>

<Tip>
  Use `rank` to sort content tiers in ascending order of rarity when building a cosmetic browser — a higher rank always indicates a rarer (and generally more expensive) tier.
</Tip>