Cosmetic Themes API — GET /v1/themes endpoints

Themes are the cosmetic collections that unite related skins, buddies, sprays, and player cards under a single brand — for example “Prime”, “Glitchpop”, or “Elderflame”. The Themes API lets you retrieve every theme available in the game or look up an individual theme by its UUID. You can use the returned uuid to cross-reference themed cosmetics across other endpoints.

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

GET /v1/themes

Returns a list of all cosmetic themes.

Use the language query parameter to retrieve localized displayName values for each theme.

Query parameters

string

default:"en-US"

BCP 47 locale string for response localization. Example: ja-JP, zh-CN, ko-KR.

Example request

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

Response

{
  "status": 200,
  "data": [
    {
      "uuid": "271874eb-491b-eae3-51f8-6f93f93035f9",
      "displayName": ".EXE",
      "displayIcon": null,
      "storeFeaturedImage": null,
      "assetPath": "ShooterGame/Content/Themes/Theme_Grid_PrimaryAsset"
    }
  ]
}

Response fields

number

required

HTTP status code of the response.

object[]

required

Array of theme objects.

Show theme properties

string

required

Unique identifier for the theme. Use this UUID to filter themed cosmetics across other endpoints (e.g. buddies, sprays, player cards).

string

required

Localized display name of the theme (e.g. "Prime", "Elderflame").

string

URL of the image used to feature this theme in the Valorant store. May be null for themes without store placements.

string

URL of the theme’s display icon. May be null.

string

required

Internal Unreal Engine asset path.

GET /v1/themes/{uuid}

Returns a single cosmetic theme by its UUID.

Path parameters

string

required

The UUID of the theme to retrieve.

Query parameters

string

default:"en-US"

BCP 47 locale string for response localization.

Example request

curl --request GET \
  --url "https://astra.teamfortuna.xyz/v1/themes/271874eb-491b-eae3-51f8-6f93f93035f9?language=en-US" \
  --header "User-Agent: MyApp/1.0 (+https://example.com)"

Response

{
  "status": 200,
  "data": {
    "uuid": "271874eb-491b-eae3-51f8-6f93f93035f9",
    "displayName": ".EXE",
    "displayIcon": null,
    "storeFeaturedImage": null,
    "assetPath": "ShooterGame/Content/Themes/Theme_Grid_PrimaryAsset"
  }
}

⌘I

System

Agents & Characters

Cosmetics

Weapons

Game Data

Premier

Localization

Cosmetic Themes API — GET /v1/themes endpoints

GET /v1/themes

Query parameters

Example request

Response

Response fields

GET /v1/themes/{uuid}

Path parameters

Query parameters

Example request

Response

​GET /v1/themes

​Query parameters

​Example request

​Response

​Response fields

​GET /v1/themes/{uuid}

​Path parameters

​Query parameters

​Example request

​Response

GET /v1/themes

Query parameters

Example request

Response

Response fields

GET /v1/themes/{uuid}

Path parameters

Query parameters

Example request

Response