GET Goldstars

https://pd.{shard}.a.pvp.net/goldstars/v1/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.

Headers

URL Parameters

Other Variables

Response

type GoldstarsResponse = {
    /** 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 */
    id: string;
    /** Internal (dev) name of the goldstar, e.g. `TopFrag`, `HeadshotPercentage` or `MVP` */
    tempT: string;
}[];