> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teamfortuna.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Player Cards API — GET /v1/playercards endpoints

> Retrieve all Valorant player cards or a single card by UUID. Player cards are profile artwork shown on the scoreboard, available in small, wide, and large art.

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.

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

***

## GET /v1/playercards

Returns a list of all player cards.

<Tip>
  Pass the `language` query parameter to receive localized `displayName` values for your target audience.
</Tip>

### Query parameters

<ParamField query="language" type="string" default="en-US">
  BCP 47 locale string for response localization. Example: `ko-KR`, `pt-BR`, `zh-TW`.
</ParamField>

### Example request

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url "https://astra.teamfortuna.xyz/v1/playercards?language=en-US" \
    --header "User-Agent: MyApp/1.0 (+https://example.com)"
  ```
</CodeGroup>

### Response

```json theme={null}
{
  "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

<ResponseField name="status" type="number" required>
  HTTP status code of the response.
</ResponseField>

<ResponseField name="data" type="object[]" required>
  Array of player card objects.

  <Expandable title="player card properties">
    <ResponseField name="uuid" type="string" required>
      Unique identifier for the player card.
    </ResponseField>

    <ResponseField name="displayName" type="string" required>
      Localized display name of the card.
    </ResponseField>

    <ResponseField name="isHiddenIfNotOwned" type="boolean" required>
      Whether the card is hidden in the store when the player does not own it.
    </ResponseField>

    <ResponseField name="themeUuid" type="string">
      UUID of the cosmetic theme this card belongs to. May be `null` for default or unthemed cards.
    </ResponseField>

    <ResponseField name="displayIcon" type="string" required>
      URL of the card's general-purpose display icon.
    </ResponseField>

    <ResponseField name="smallArt" type="string" required>
      URL of the small art variant, used in compact UI contexts.
    </ResponseField>

    <ResponseField name="wideArt" type="string" required>
      URL of the wide art variant, used in horizontal banner contexts such as the scoreboard header.
    </ResponseField>

    <ResponseField name="largeArt" type="string" required>
      URL of the large art variant, used in full-size profile displays.
    </ResponseField>

    <ResponseField name="assetPath" type="string" required>
      Internal Unreal Engine asset path.
    </ResponseField>
  </Expandable>
</ResponseField>

***

## GET /v1/playercards/\{uuid}

Returns a single player card by its UUID.

### Path parameters

<ParamField path="uuid" type="string" required>
  The UUID of the player card to retrieve.
</ParamField>

### Query parameters

<ParamField query="language" type="string" default="en-US">
  BCP 47 locale string for response localization.
</ParamField>

### Example request

<CodeGroup>
  ```bash cURL theme={null}
  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)"
  ```
</CodeGroup>

### Response

```json theme={null}
{
  "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"
  }
}
```