Valorant API Unofficial docs
API Reference Goldstars
GET

Player Goldstars

Get the goldstars ("medals") of a player: how often each goldstar was earned per act, the best value per act, and a breakdown of recent matches.

Works for other players' PUUIDs as well. The values change after every match, so only cache them briefly.

The response keys are obfuscated and have changed between response versions (31 and 32 have been observed): in version 31 kills, assists and plants were sent per round, in version 32 as the match total. To determine the unit of a goldstar, divide the real match total by the goldstar value - a result of about 1 means the goldstar is the match total, a result close to the number of rounds means it is a per-round value. Values are float32, so numbers like 24.000001 are normal and should be rounded for display.

The season ID 00000000-0000-0000-0000-000000000000 in tempS is not a real act but the all-time summary. The id of a match is always an empty string, so the only link to the match history is the start time in tempG - matching a match from the history with the closest entry in tempM within about ten minutes works in practice.

The meaning of the goldstar IDs is listed in the Goldstars endpoint.

For a player without any goldstars, tempS and tempM are empty. Matches in which no player earned a goldstar exist as well, in which case tempP is an empty object.

Server PD · shard Auth Bearer + Entitlements
GET https://pd.{shard}.a.pvp.net/goldstars/v1/players/{puuid}
Try this request in the browser with your own values

Headers

X-Riot-ClientPlatform string required
Value {client platform}— Base64-encoded client platform JSON
X-Riot-ClientVersion string required
Value {client version}— The current Valorant client version
X-Riot-Entitlements-JWT string required
Value {entitlement token}— From the Entitlements Token or Entitlement endpoint
Authorization string required
Value Bearer {auth token}— From the Entitlements Token endpoint or Riot auth

URL parameters

shard enum required

na, pbe, eu, ap or kr: depends on where the account was created.

napbeeuapkr
How to get it

The shard is dependent on where the Riot account was created.
There are 5 shards:

Shard Region(s)
na latam, br, na
pbe na
eu eu
ap ap
kr kr
Obtaining locally:

The shard can be found in the ShooterGame log (%LocalAppData%\VALORANT\Saved\Logs\ShooterGame.log ) when it's used in an endpoint url.
Example regex capturing region and shard: https://glz-(.+?)-1.(.+?).a.pvp.net

Obtaining remotely:

The shard can be found from using a lookup table with the region. To find the region, use the Riot Geo endpoint with the ID and auth tokens from Cookie Reauth

puuid string · uuid required
A player's UUID

Other variables

client platform Base64-encoded client platform JSON.
Details

A string representing the platform of the client. Base-64 encoded JSON with the following fields:

{
    "platformType": "PC",
    "platformOS": "Windows",
    "platformOSVersion": "10.0.26200.1.256.64bit",
    "platformChipset": "Unknown"
}
ewoJInBsYXRmb3JtVHlwZSI6ICJQQyIsCgkicGxhdGZvcm1PUyI6ICJXaW5kb3dzIiwKCSJwbGF0Zm9ybU9TVmVyc2lvbiI6ICIxMC4wLjI2MjAwLjEuMjU2LjY0Yml0IiwKCSJwbGF0Zm9ybUNoaXBzZXQiOiAiVW5rbm93biIKfQ== is a value that works.

client version The current Valorant client version.
Details

The version of the Valorant client. This can be obtained in a number of ways:

  • Parsing the ShooterGame log at %LocalAppData%\VALORANT\Saved\Logs\ShooterGame.log
  • Using the Sessions endpoint
  • Using the third-party RadiantConnect version endpoint (data.riot_client_version )
  • Using the third-party Versions endpoint
Sessions
entitlement token From the Entitlements Token or Entitlement endpoint.
Details
Can be obtained locally with the Entitlements Token endpoint or remotely using Riot auth and the Entitlement endpoint
Entitlements Token
auth token From the Entitlements Token endpoint or Riot auth.
Details
Can be obtained locally with the Entitlements Token endpoint or remotely by first using the Auth Cookies endpoint then using the cookies with the Auth Request endpoint
Authentication

Response

puuid string · uuid

Player UUID

version number

Version of the response format, 31 and 32 have been observed

tempS record<string, object>

Act ID to the summary of that act. The all-zero ID is the all-time summary instead of a real act

Show nested attributes Hide nested attributes 2
tempS string · uuid

Duplicate of the act ID

tempA record<string, object>

Goldstar ID to the summary of that goldstar for the act

Show nested attributes Hide nested attributes 3
id string · uuid

Goldstar ID

tempC number

How often the goldstar was earned during the act

tempB number

Best value of the goldstar during the act

tempM array[object]

Recent matches with goldstars

Show nested attributes Hide nested attributes 3
id string

Always an empty string - the match ID is not returned

tempG number

Start time of the match in milliseconds since epoch

tempP record<string, object>

Player UUID to the goldstars of that player in this match. Contains all participants, not just the requested player

Show nested attributes Hide nested attributes 1
tempA record<string, object>

Goldstar ID to the value of that goldstar in this match

Show nested attributes Hide nested attributes 3
id string · uuid

Goldstar ID

tempV number

Value of the goldstar in this match

tempB boolean

Whether the value is a record for the act