Weapon Skins API — GET /v1/weapons/skins endpoints

Weapon skins are cosmetic reskins that change the visual appearance of a weapon. Each skin belongs to a named theme collection (such as “Prime” or “Glitchpop”) identified by a themeUuid, and may have a contentTierUuid indicating its rarity tier. A skin is composed of two sub-collections: chromas (color or style variants of the skin) and levels (Radianite-unlocked upgrade tiers that add effects or animations). Use the list endpoint to browse all skins or the UUID endpoint to retrieve a specific one.

Skin hierarchy

Understanding the relationship between skins, chromas, and levels helps you build richer UI:

A skin is the top-level cosmetic item and represents the full package for a weapon theme.
Chromas are color or style variants within that skin. The first chroma (index 0) is always the base skin appearance. Additional chromas are unlocked with Radianite Points.
Levels are progressive upgrades within the skin, also unlocked with Radianite Points. Each level adds a new feature such as visual effects, custom animations, or a finisher. See the Skin Levels endpoints for full level details, and Skin Chromas for standalone chroma lookups.

GET /v1/weapons/skins

Retrieve a list of all weapon skins in Valorant, each including their chromas and levels.

Query parameters

string

default:"en-US"

The locale used for all display name strings in the response. Accepts any Valorant-supported locale, for example en-US, de-DE, ja-JP, or zh-TW.

Example request

curl --request GET \
  --url "https://astra.teamfortuna.xyz/v1/weapons/skins" \
  --header "User-Agent: MyApp/1.0 (+https://example.com)"

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

Response

number

required

HTTP status code of the response. 200 indicates success.

object[]

required

Array of weapon skin objects.

Show data[] properties

string

required

Unique identifier for this skin.

string

required

Human-readable skin name, such as "Prime Vandal".

string

required

UUID of the theme collection this skin belongs to (for example, the “Prime” collection).

string | null

UUID of the content tier (rarity level) for this skin. null for default skins with no rarity tier.

string | null

URL to the skin’s primary display icon image.

string | null

URL to a full-resolution wallpaper image for the skin, if available.

string

required

Internal Unreal Engine asset path for the skin.

object[]

required

Color and style variants for this skin. The first element is always the base skin color.

Show chromas[] properties

string

required

Unique identifier for this chroma.

string

required

Display name of the chroma variant, such as "Prime Vandal" (base) or "Prime Vandal\nVariant 1 Yellow".

string | null

URL to the chroma’s display icon.

string | null

URL to a full-resolution render of the weapon in this chroma.

string | null

URL to a small color swatch image, useful for color picker UI elements.

string | null

URL to a preview video for this chroma, if available.

string

required

Internal Unreal Engine asset path for this chroma.

object[]

required

Upgrade tiers for this skin, unlocked progressively with Radianite Points.

Show levels[] properties

string

required

Unique identifier for this level.

string

required

Display name of the level, such as "Prime Vandal Level 1".

string | null

The type of upgrade this level adds, for example "EEquippableSkinLevelItem::VFX". null for the base level. See the Skin Levels reference for all possible values.

string | null

URL to the level’s display icon.

string | null

URL to a preview video for this level’s effect, if available.

string

required

Internal Unreal Engine asset path for this level.

Response

{
  "status": 200,
  "data": [
    {
      "uuid": "67d3e2f7-4b73-7598-0027-63bd9e2e5fcc",
      "displayName": ".EXE Ghost",
      "themeUuid": "271874eb-491b-eae3-51f8-6f93f93035f9",
      "contentTierUuid": "12683d76-48d7-84a3-4e09-6985794f0445",
      "displayIcon": null,
      "wallpaper": null,
      "assetPath": "ShooterGame/Content/Equippables/Guns/Sidearms/Luger/Grid/LugerPistol_Grid_PrimaryAsset",
      "chromas": [
        {
          "uuid": "12966603-4cb3-03dd-bf2e-338fb15d144f",
          "displayName": ".EXE Ghost",
          "displayIcon": "https://valmedia.teamfortuna.xyz/weapons-skinchromas/12966603-4cb3-03dd-bf2e-338fb15d144f/displayicon.png",
          "fullRender": "https://valmedia.teamfortuna.xyz/weapons-skinchromas/12966603-4cb3-03dd-bf2e-338fb15d144f/fullrender.png",
          "swatch": null,
          "streamedVideo": null,
          "assetPath": "ShooterGame/Content/Equippables/Guns/Sidearms/Luger/Grid/Chromas/Standard/LugerPistol_Grid_Standard_PrimaryAsset"
        }
      ],
      "levels": [
        {
          "uuid": "9466088a-4ad8-cb08-ec9a-45aaba3a6acd",
          "displayName": ".EXE Ghost",
          "levelItem": null,
          "displayIcon": "https://valmedia.teamfortuna.xyz/weapons-skinlevels/9466088a-4ad8-cb08-ec9a-45aaba3a6acd/displayicon.png",
          "streamedVideo": null,
          "assetPath": "ShooterGame/Content/Equippables/Guns/Sidearms/Luger/Grid/Levels/LugerPistol_GridLv1_PrimaryAsset"
        }
      ]
    }
  ]
}

System

Agents & Characters

Cosmetics

Weapons

Game Data

Premier

Localization

Weapon Skins API — GET /v1/weapons/skins endpoints

Skin hierarchy

GET /v1/weapons/skins

Query parameters

Example request

Response

Response

​Skin hierarchy

​GET /v1/weapons/skins

​Query parameters

​Example request

​Response

​Response

Skin hierarchy

GET /v1/weapons/skins

Query parameters

Example request

Response

Response