Skins

Cosmetic skins from the current game patch. Records include artwork, acquisition sources, shop prices, applicable items or classes, and gameplay modifiers when the game publishes them.

Use the catalog matching the cosmetic slot: item_skins, armor_skins, character_skins, action_skins, nameplate_skins, or lobby_skins.

GET/v2/item_skins

Replace item_skins with any skin catalog above. Each result uses its matching canonical id.<skin_kind>.<slug> id.

target_itemoptional
Filter item or armor skins by an exact canonical item archetype id.
classoptional
Filter character skins by exact canonical class id membership.
patchoptional
Return skins introduced by one exact game patch.
localeoptionalglobal
Language used to resolve localized names, descriptions, and labels.
Default
en
sortoptionalglobal
Sort by a field and direction. Use field:order, such as name:asc, or use asc or desc for the endpoint's default field.
cursoroptionalglobal
Continue from the previous page. Pass the opaque pagination.next value unchanged. Omit it for the first page.
limitglobal
Pagination
Accepted
1 - 200
Default
50

GET/v2/item_skins/{id}

idpath
Pick any item skin id from the list.
localeoptionalglobal
Language used to resolve localized names, descriptions, and labels.
Default
en

The sources array preserves each game-data source. A shop source may also carry exclusive_source_key for a second way to earn the skin, such as Twitch Drops.

GET/v2/item_skins/{id}/icon

idpath
Pick any item skin id from the list.
sizeoptionalglobal
Icon transforms — resize to N (square) or WxH. 1–512 per axis.
Example
64 or 64x96
dproptionalglobal
Icon transforms — pixel-density multiplier (1, 2, or 3). Combine with size for retina renders.
formatoptionalglobal
Icon transforms — re-encode. Omit to keep the source format.
trimoptionalglobal
Icon transforms — auto-strip transparent margin (1% fuzz).
bgoptionalglobal
Icon transforms — background fill (#RRGGBB, #RRGGBBAA, or transparent).
Example
#000000 or transparent

GET/v2/item_skins/{id}/tooltip

idpath
Pick any item skin id from the list.
localeoptionalglobal
Language used to resolve localized names, descriptions, and labels.
Default
en

Returns the compact profile payload used by the embeddable skin tooltip. See the Tooltips guide for installation and supported skin kinds.

GET/v2/character_skins/{id}/model

idpath
Pick a character skin with has_model set to true.

Returns a GLB model when the skin has an exact matching creature model in the current game assets. Skins without verified model artwork return 404.