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

​
language
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

​
status
number
required
HTTP status code of the response.
​
data
object[]
required
Array of theme objects.

​
GET /v1/themes/{uuid}

Returns a single cosmetic theme by its UUID.

​
Path parameters

​
uuid
string
required
The UUID of the theme to retrieve.

​
Query parameters

​
language
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"
  }
}