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.
Headers
X-Riot-ClientPlatform string required {client platform}— Base64-encoded client platform JSON X-Riot-ClientVersion string required {client version}— The current Valorant client version X-Riot-Entitlements-JWT string required {entitlement token}— From the Entitlements Token or Entitlement endpoint Authorization string required 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.
napbeeuapkrHow 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 |
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
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 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
entitlement token From the Entitlements Token or Entitlement endpoint. Details
auth token From the Entitlements Token endpoint or Riot auth. Details
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