Player Cards API — GET /v1/playercards endpoints

Player cards are cosmetic profile images that players display in Valorant’s in-game scoreboard and social panels. Each card ships in three image variants — small, wide, and large — making them suitable for different UI layouts. You can retrieve the full collection of player cards or look up a specific card by its UUID.

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

GET /v1/playercards

Returns a list of all player cards.

Pass the language query parameter to receive localized displayName values for your target audience.

Query parameters

string

default:"en-US"

BCP 47 locale string for response localization. Example: ko-KR, pt-BR, zh-TW.

Example request

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

Response

{
  "status": 200,
  "data": [
    {
      "uuid": "cfd8d9e8-4984-21ed-00a6-53916619c68f",
      "displayName": ".SYS Card",
      "isHiddenIfNotOwned": false,
      "themeUuid": null,
      "displayIcon": null,
      "smallArt": "https://valmedia.teamfortuna.xyz/playercards/cfd8d9e8-4984-21ed-00a6-53916619c68f/smallart.png",
      "wideArt": "https://valmedia.teamfortuna.xyz/playercards/cfd8d9e8-4984-21ed-00a6-53916619c68f/wideart.png",
      "largeArt": "https://valmedia.teamfortuna.xyz/playercards/cfd8d9e8-4984-21ed-00a6-53916619c68f/largeart.png",
      "assetPath": "ShooterGame/Content/Personalization/PlayerCards/Ep4_Act3_BP/Grid2/Playercard_Grid2_PrimaryAsset"
    }
  ]
}

Response fields

number

required

HTTP status code of the response.

object[]

required

Array of player card objects.

Show player card properties

string

required

Unique identifier for the player card.

string

required

Localized display name of the card.

boolean

required

Whether the card is hidden in the store when the player does not own it.

string

UUID of the cosmetic theme this card belongs to. May be null for default or unthemed cards.

string

required

URL of the card’s general-purpose display icon.

string

required

URL of the small art variant, used in compact UI contexts.

string

required

URL of the wide art variant, used in horizontal banner contexts such as the scoreboard header.

string

required

URL of the large art variant, used in full-size profile displays.

string

required

Internal Unreal Engine asset path.

GET /v1/playercards/{uuid}

Returns a single player card by its UUID.

Path parameters

string

required

The UUID of the player card 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/playercards/cfd8d9e8-4984-21ed-00a6-53916619c68f?language=en-US" \
  --header "User-Agent: MyApp/1.0 (+https://example.com)"

Response

{
  "status": 200,
  "data": {
    "uuid": "cfd8d9e8-4984-21ed-00a6-53916619c68f",
    "displayName": ".SYS Card",
    "isHiddenIfNotOwned": false,
    "themeUuid": null,
    "displayIcon": null,
    "smallArt": "https://valmedia.teamfortuna.xyz/playercards/cfd8d9e8-4984-21ed-00a6-53916619c68f/smallart.png",
    "wideArt": "https://valmedia.teamfortuna.xyz/playercards/cfd8d9e8-4984-21ed-00a6-53916619c68f/wideart.png",
    "largeArt": "https://valmedia.teamfortuna.xyz/playercards/cfd8d9e8-4984-21ed-00a6-53916619c68f/largeart.png",
    "assetPath": "ShooterGame/Content/Personalization/PlayerCards/Ep4_Act3_BP/Grid2/Playercard_Grid2_PrimaryAsset"
  }
}

⌘I

System

Agents & Characters

Cosmetics

Weapons

Game Data

Premier

Localization

Player Cards API — GET /v1/playercards endpoints

GET /v1/playercards

Query parameters

Example request

Response

Response fields

GET /v1/playercards/{uuid}

Path parameters

Query parameters

Example request

Response

​GET /v1/playercards

​Query parameters

​Example request

​Response

​Response fields

​GET /v1/playercards/{uuid}

​Path parameters

​Query parameters

​Example request

​Response

GET /v1/playercards

Query parameters

Example request

Response

Response fields

GET /v1/playercards/{uuid}

Path parameters

Query parameters

Example request

Response