GET Roster
https://pd.{shard}.a.pvp.net/premier/v2/rosters/{rosterid} Get Premier roster (team) data by roster ID, including members, customization, and seasonal stats.
Headers
-
X-Riot-ClientPlatform: {client platform} -
X-Riot-ClientVersion: {client version} -
X-Riot-Entitlements-JWT: {entitlement token} -
Authorization: Bearer {auth token}
URL Parameters
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 RosterResponse = {
/** UUID */
rosterId: string;
/** Region affinity, e.g. "eu", "na" */
affinity: string;
name: string;
tag: string;
customization: {
/** UUID */
icon: string;
/** Unreal Engine color string */
primaryColor: string;
secondaryColor: string;
tertiaryColor: string;
};
members: {
/** Player UUID */
puuid: string;
role: "OWNER" | "MEMBER";
roleId: number;
/** Unix timestamp (seconds) */
createdAt: number;
}[];
invites: unknown[];
locks: unknown[];
season: {
/** UUID */
id: string;
isEnrolled: boolean;
conference: string;
division: number;
isProvisionalDivision: boolean;
promotionApplied: boolean;
points: number;
wins: number;
gamesPlayed: number;
seasonMatchRoundWins: number;
seasonMatchRoundsPlayed: number;
/** e.g. "NONE", "COMPETITOR", "PLAYOFFS" */
crest: string;
hasEarnedPromotionForNextSeason: boolean;
hasEarnedPrestige: boolean;
};
minimumRequiredMembersForEnrollment: number;
matchesSinceReset: number;
tournamentsSinceReset: number;
version: {
socialVersion: number;
premierVersion: number;
};
/** Unix timestamp (seconds) */
updatedAt: number;
/** Unix timestamp (seconds) */
createdAt: number;
seasonalInfoBySeasonID: {
[x: string]: {
/** UUID */
id: string;
isEnrolled: boolean;
conference: string;
division: number;
isProvisionalDivision: boolean;
promotionApplied: boolean;
points: number;
wins: number;
gamesPlayed: number;
seasonMatchRoundWins: number;
seasonMatchRoundsPlayed: number;
/** e.g. "NONE", "COMPETITOR", "PLAYOFFS" */
crest: string;
hasEarnedPromotionForNextSeason: boolean;
hasEarnedPrestige: boolean;
};
};
prestige: {
earnedPrestige: boolean;
plating: string;
};
}; {
"rosterId": "73044C9a-578F-0067-FF6B-5A3Ce256E960",
"affinity": "derideo",
"name": "Perry Green Jr.",
"tag": "undique",
"customization": {
"icon": "FCf1eC29-f5f5-2Bf1-564d-EE69BF9de5c6",
"primaryColor": "turbo",
"secondaryColor": "somniculosus",
"tertiaryColor": "provident"
},
"members": [
{
"puuid": "16253AcA-C6a7-1Fb1-5a31-E65f6Bb8bc9a",
"role": "MEMBER",
"roleId": 4542665119071111,
"createdAt": 6997574033593424
},
{
"puuid": "fa19aBFF-02Bb-D2C9-5BCf-E61Fd1eCDAac",
"role": "MEMBER",
"roleId": 7050888156397250,
"createdAt": 3817472595050376
},
{
"puuid": "CbcEEBc1-fC8f-4d7B-94A6-84aFDADc5328",
"role": "OWNER",
"roleId": 4042292830340047,
"createdAt": 1193952637821308
},
{
"puuid": "206c881C-3901-0cc0-fB75-24B6AA7b3cc6",
"role": "OWNER",
"roleId": 1307355507018199,
"createdAt": 2860313283148726
}
],
"invites": [
null
],
"locks": [
null,
null,
null
],
"season": {
"id": "7cC56FdF-eC9b-6Fad-E98e-c7CE3E5FE25D",
"isEnrolled": false,
"conference": "verbera",
"division": 3145865053271400,
"isProvisionalDivision": false,
"promotionApplied": true,
"points": 579408856992077,
"wins": 8841451094015898,
"gamesPlayed": 4826192005868447,
"seasonMatchRoundWins": 6997248247655607,
"seasonMatchRoundsPlayed": 974244096905443,
"crest": "explicabo",
"hasEarnedPromotionForNextSeason": false,
"hasEarnedPrestige": false
},
"minimumRequiredMembersForEnrollment": 4349933515402612,
"matchesSinceReset": 3422349064802892,
"tournamentsSinceReset": 1160588856322571,
"version": {
"socialVersion": 5871545011868337,
"premierVersion": 2162083714009034
},
"updatedAt": 943510685040527,
"createdAt": 2110520924160401,
"seasonalInfoBySeasonID": {
"7E30DEbd-4eBC-C2bd-81A7-bcbeFA2Ebb58": {
"id": "6Df9cE5d-8b83-bdB5-eacE-981833b93ab4",
"isEnrolled": false,
"conference": "derideo",
"division": 6952066589711085,
"isProvisionalDivision": false,
"promotionApplied": false,
"points": 8195301232822062,
"wins": 3405100288607767,
"gamesPlayed": 7167931087348276,
"seasonMatchRoundWins": 1103808446937283,
"seasonMatchRoundsPlayed": 67221981484143,
"crest": "urbanus",
"hasEarnedPromotionForNextSeason": false,
"hasEarnedPrestige": true
}
},
"prestige": {
"earnedPrestige": false,
"plating": "eveniet"
}
}