> ## 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.

# Flex Cosmetics API — GET /v1/flex endpoints

> Retrieve all Valorant flex cosmetics or a single flex item by UUID. Flex items are special cosmetics earned through gameplay achievements.

Flex items are a category of Valorant cosmetics — including titles, icons, and other display items — that players earn by completing special gameplay milestones rather than purchasing from the store. The Flex API gives you access to every flex item available in the game, along with display icons and localized names, either as a full list or as individual lookups by UUID.

<Note>
  All requests must include a `User-Agent` header in the format `AppName/Version (+URL)`. Requests without it will be rejected.
</Note>

***

## GET /v1/flex

Returns a list of all flex cosmetic items.

<Tip>
  Use the `language` query parameter to retrieve localized `displayName` values for your target locale.
</Tip>

### Query parameters

<ParamField query="language" type="string" default="en-US">
  BCP 47 locale string for response localization. Example: `de-DE`, `fr-FR`, `pt-BR`.
</ParamField>

### Example request

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

### Response

```json theme={null}
{
  "status": 200,
  "data": [
    {
      "uuid": "cb4bf100-4590-c564-c805-67bcf98b7baa",
      "displayName": ":D Flex",
      "displayIcon": "https://valmedia.teamfortuna.xyz/flex/cb4bf100-4590-c564-c805-67bcf98b7baa/displayicon.png",
      "assetPath": "ShooterGame/Content/Equippables/Totems/Hazard/Totem_Hazard_PrimaryAsset"
    }
  ]
}
```

### Response fields

<ResponseField name="status" type="number" required>
  HTTP status code of the response.
</ResponseField>

<ResponseField name="data" type="object[]" required>
  Array of flex item objects.

  <Expandable title="flex item properties">
    <ResponseField name="uuid" type="string" required>
      Unique identifier for the flex item.
    </ResponseField>

    <ResponseField name="displayName" type="string" required>
      Localized display name of the flex item.
    </ResponseField>

    <ResponseField name="displayIcon" type="string">
      URL of the flex item's display icon. May be `null` for items without a visual icon.
    </ResponseField>

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

***

## GET /v1/flex/\{uuid}

Returns a single flex item by its UUID.

### Path parameters

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

### Query parameters

<ParamField query="language" type="string" default="en-US">
  BCP 47 locale string for response localization.
</ParamField>

### Example request

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url "https://astra.teamfortuna.xyz/v1/flex/cb4bf100-4590-c564-c805-67bcf98b7baa?language=en-US" \
    --header "User-Agent: MyApp/1.0 (+https://example.com)"
  ```
</CodeGroup>

### Response

```json theme={null}
{
  "status": 200,
  "data": {
    "uuid": "cb4bf100-4590-c564-c805-67bcf98b7baa",
    "displayName": ":D Flex",
    "displayIcon": "https://valmedia.teamfortuna.xyz/flex/cb4bf100-4590-c564-c805-67bcf98b7baa/displayicon.png",
    "assetPath": "ShooterGame/Content/Equippables/Totems/Hazard/Totem_Hazard_PrimaryAsset"
  }
}
```