Skins

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

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

Races are character skins and have their own page: Races.

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