GET Player Goldstars
https://pd.{shard}.a.pvp.net/goldstars/v1/players/{puuid} 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: {client platform} -
X-Riot-ClientVersion: {client version} -
X-Riot-Entitlements-JWT: {entitlement token} -
Authorization: Bearer {auth token}
URL Parameters
-
{puuid}A player's UUID
Other Variables
-
client platformA string representing the platform of the client. Base-64 encoded JSON with the following fields:
{ "platformType": "PC", "platformOS": "Windows", "platformOSVersion": "10.0.19042.1.256.64bit", "platformChipset": "Unknown" }ew0KCSJwbGF0Zm9ybVR5cGUiOiAiUEMiLA0KCSJwbGF0Zm9ybU9TIjogIldpbmRvd3MiLA0KCSJwbGF0Zm9ybU9TVmVyc2lvbiI6ICIxMC4wLjE5MDQyLjEuMjU2LjY0Yml0IiwNCgkicGxhdGZvcm1DaGlwc2V0IjogIlVua25vd24iDQp9is a value that works. -
client version -
entitlement tokenCan be obtained locally with the Entitlements Token endpoint or remotely using Riot auth and the Entitlement endpoint -
auth tokenCan 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
Response
type PlayerGoldstarsResponse = {
/** Player UUID */
puuid: string;
/** Version of the response format, 31 and 32 have been observed */
version: number;
/** Act ID to the summary of that act. The all-zero ID is the all-time summary instead of a real act */
tempS: {
[x: string]: {
/** Duplicate of the act ID */
tempS: string;
/** Goldstar ID to the summary of that goldstar for the act */
tempA: {
[x: string]: {
/** Goldstar ID */
id: string;
/** How often the goldstar was earned during the act */
tempC: number;
/** Best value of the goldstar during the act */
tempB: number;
};
};
};
};
/** Recent matches with goldstars */
tempM: {
/** Always an empty string - the match ID is not returned */
id: string;
/** Start time of the match in milliseconds since epoch */
tempG: number;
/** Player UUID to the goldstars of that player in this match. Contains all participants, not just the requested player */
tempP: {
[x: string]: {
/** Goldstar ID to the value of that goldstar in this match */
tempA: {
[x: string]: {
/** Goldstar ID */
id: string;
/** Value of the goldstar in this match */
tempV: number;
/** Whether the value is a record for the act */
tempB: boolean;
};
};
};
};
}[];
};{
"puuid": "A0EC314B-Fd1b-554f-61BF-DfCe73EFbae5",
"version": 6220949576984620,
"tempS": {
"88ccffb2-5F13-077f-B3F3-aF5E2A5CCaA1": {
"tempS": "AB693E17-3eAb-DbC3-e8Df-C9faccd7dA9C",
"tempA": {
"4dBe8Fb0-EE6e-77af-C9C1-8185e31fE0fB": {
"id": "4dbe076E-Aaab-f8d4-167E-1eDfDAcF8CF9",
"tempC": 5498670630665198,
"tempB": 4803119818489562
}
}
}
},
"tempM": [
{
"id": "congregatio",
"tempG": 3795077703511549,
"tempP": {
"170E6a5B-DE5A-44DA-2f0d-33CaC2FbcFD6": {
"tempA": {
"B6Fd5dA2-A5dB-bC9E-A9eC-24d6cAe2ccF3": {
"id": "2DAdCd35-DCe1-5dC5-4eA9-e75edb0bc7fd",
"tempV": 7891820438476679,
"tempB": false
}
}
}
}
},
{
"id": "cur",
"tempG": 7036953463035544,
"tempP": {
"31bd5fbc-C118-dE85-C9cf-2821EBdcc5A7": {
"tempA": {
"d3edCA7e-D9Fd-4baE-cD09-EFd8e2FC9f7e": {
"id": "da3Fc4Bd-6E6D-AE6D-cC57-E3bf53CEB4A8",
"tempV": 5075449916797102,
"tempB": true
}
}
}
}
},
{
"id": "labore",
"tempG": 6719291431769325,
"tempP": {
"B4Bcb1c3-1f42-Cb88-75D5-3ddb32872D23": {
"tempA": {
"ccA8DE30-919A-dAaB-4C0B-0276cA69a4e0": {
"id": "F1aBDF56-Dc0d-C6b8-03ac-87ec9C3D8Fe6",
"tempV": 748182173972858,
"tempB": false
}
}
}
}
}
]
}