Valorant API Unofficial docs
API Reference Goldstars
GET

Goldstars

Get the list of all existing goldstars ("medals"), the awards shown after a match for stats such as kills, assists or headshot percentage.

The list does not depend on the player and rarely changes, so it can be cached for a long time. Riot does not return localized names or descriptions - the only name is the internal one in the obfuscated tempT field, which has also been observed under the keys displayName, name, title and devName in different client builds.

The internal names in the tempT field identify every goldstar, including the three that could previously only be guessed from the data. The meaning column below was confirmed by comparing the values of the Player Goldstars endpoint with the stats of the same matches from the Match Details endpoint:

Goldstar ID Internal name Meaning
6dc31cfd-41da-895f-9246-a8b63558cdb8 Damage Damage per round (ADR)
2c8b6129-4384-230d-c7e5-cda12019533c HeadshotPercentage Headshot percentage of the match
1b13755f-4d5a-2c9e-6a39-bea7e6c53e7f Kills Kills
1c926cba-48cb-8aeb-c68d-a1ba2d012784 TopFrag Top fragger of the match; the value equals that player's kills
e43f9acb-448c-4aa1-1591-6db72c0b8dae Assists Assists
352a3ac8-4b2c-db6a-1f36-c0a67b428e65 Plants Spike plants
bfe96c47-44d0-e473-585d-749146d2d05e FirstBlood First kills
244cf4ab-4c27-cc59-3323-c985858d6ddb Aces Aces
0497d585-42ad-61a7-42bc-189571f40e2c Clutches Clutches of 1v2 and higher
3bc0563a-4fe9-a15c-0078-23a3408d64b5 Trades Trade kills; observed as an integer between 6 and 11 per match, awarded to several players at once
745b27f0-4bc2-13a4-4ee7-77be323155c2 MVP Match MVP: a combined match rating capped at 500, awarded to exactly one player of the match
4815a8a2-4649-9bfe-afd2-38ae9cc22898 Distinction The same value as the MVP goldstar (745b27f0-4bc2-13a4-4ee7-77be323155c2), but awarded to everyone above roughly 420

The MVP, Distinction and Trades values could not be reproduced from the data of the Match Details endpoint and are likely server-side stats that are not part of the match details. Any other ID returned by this endpoint is unknown - use its tempT internal name as a hint. Note that the units of the identified goldstars are not fixed either, see the Player Goldstars endpoint for how to determine them.

Server PD · shard Auth Bearer + Entitlements
GET https://pd.{shard}.a.pvp.net/goldstars/v1/goldstars
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

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

id string · uuid

Goldstar ID. Known IDs (internal `tempT` name in parentheses): - `6dc31cfd-41da-895f-9246-a8b63558cdb8` - damage per round / ADR (`Damage`) - `2c8b6129-4384-230d-c7e5-cda12019533c` - headshot percentage of the match (`HeadshotPercentage`) - `1b13755f-4d5a-2c9e-6a39-bea7e6c53e7f` - kills (`Kills`) - `1c926cba-48cb-8aeb-c68d-a1ba2d012784` - top fragger of the match, value equals that player's kills (`TopFrag`) - `e43f9acb-448c-4aa1-1591-6db72c0b8dae` - assists (`Assists`) - `352a3ac8-4b2c-db6a-1f36-c0a67b428e65` - spike plants (`Plants`) - `bfe96c47-44d0-e473-585d-749146d2d05e` - first kills (`FirstBlood`) - `244cf4ab-4c27-cc59-3323-c985858d6ddb` - aces (`Aces`) - `0497d585-42ad-61a7-42bc-189571f40e2c` - clutches of 1v2 and higher (`Clutches`) - `3bc0563a-4fe9-a15c-0078-23a3408d64b5` - trade kills, observed as an integer between 6 and 11 per match, awarded to several players at once (`Trades`) - `745b27f0-4bc2-13a4-4ee7-77be323155c2` - match MVP, a combined match rating capped at 500, awarded to exactly one player of the match (`MVP`) - `4815a8a2-4649-9bfe-afd2-38ae9cc22898` - the same value as the MVP goldstar `745b27f0-4bc2-13a4-4ee7-77be323155c2` but awarded to everyone above roughly 420 (`Distinction`) - any other ID - unknown, use its `tempT` internal name as a hint

tempT string

Internal (dev) name of the goldstar, e.g. `TopFrag`, `HeadshotPercentage` or `MVP`