GET Upcoming Matches
https://pd.{shard}.a.pvp.net/esports-service/v2/upcomingMatches?leagueID={leagueID}&locale={locale}&sport={sport} Get upcoming esports matches for VCT leagues. Returns leagues, tournaments, and teams data.
Headers
-
X-Riot-Entitlements-JWT: {entitlement token} -
Authorization: Bearer {auth token}
URL Parameters
Query Parameters
-
leagueIDrequiredComma-separated list of league IDs. Default VCT leagues: 107254585505459304,109940824119741550,109974795266458277,106109559530232966,109974804058058602,111691194187846945,109222784797127274
-
localeoptionalLocale for localized names, e.g. "ru-RU", "en-US"
-
sportoptionalSport identifier, always "val" for Valorant
Other Variables
-
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 UpcomingMatchesResponse = {
Leagues: {
ID: string;
Name: string;
ImageURL: string;
TournamentIDs: string[];
TeamIDs: string[] | null;
}[];
Tournaments: {
ID: string;
Name: string;
LeagueID: string;
LeagueName: string;
/** ISO 8601 date string */
StartTime: string;
/** ISO 8601 date string */
EndTime: string;
StageIDs: string[];
TeamIDs: string[];
}[];
Teams: {
ID: string;
Name: string;
Code: string;
BaseImageURL: string;
HighResImageURL: string;
LowResImageURL: string;
HomeLeagueID: string;
TeamMemberIDs: string[] | null;
BundleID: string;
BundleDataAssetID: string;
DataAssetID: string;
}[];
Seasons: null;
Splits: null;
}; {
"Leagues": [
{
"ID": "ustilo",
"Name": "Debbie Koss",
"ImageURL": "https://picsum.photos/seed/1i3DYnc/568/307",
"TournamentIDs": [
"aeternus",
"optio",
"arbor"
],
"TeamIDs": [
"audacia",
"uter",
"cattus",
"absconditus"
]
},
{
"ID": "corrupti",
"Name": "Darrell Dach",
"ImageURL": "https://picsum.photos/seed/xrVTYIN6/276/2359",
"TournamentIDs": [
"videlicet",
"cunabula",
"aufero",
"acer",
"degero"
],
"TeamIDs": [
"auctor",
"decimus"
]
},
{
"ID": "ocer",
"Name": "Keith Barrows",
"ImageURL": "https://picsum.photos/seed/AjWdbWo/2757/2828",
"TournamentIDs": [
"acquiro",
"truculenter",
"audeo"
],
"TeamIDs": [
"traho",
"angulus",
"arceo"
]
}
],
"Tournaments": [
{
"ID": "deripio",
"Name": "Dr. Van Balistreri",
"LeagueID": "venustas",
"LeagueName": "tunc",
"StartTime": "suppellex",
"EndTime": "maiores",
"StageIDs": [
"vulnus"
],
"TeamIDs": [
"administratio",
"abbas",
"centum",
"cavus"
]
},
{
"ID": "peccatus",
"Name": "Cora Gutkowski",
"LeagueID": "correptius",
"LeagueName": "conservo",
"StartTime": "deleniti",
"EndTime": "nulla",
"StageIDs": [
"clementia",
"demum",
"suscipio",
"sustineo"
],
"TeamIDs": [
"valde",
"strues",
"curtus",
"sodalitas"
]
}
],
"Teams": [
{
"ID": "tollo",
"Name": "Rickey Kohler",
"Code": "desipio",
"BaseImageURL": "apparatus",
"HighResImageURL": "contabesco",
"LowResImageURL": "caveo",
"HomeLeagueID": "sollicito",
"TeamMemberIDs": [
"delibero",
"nisi",
"tametsi",
"sit",
"terreo"
],
"BundleID": "armarium",
"BundleDataAssetID": "currus",
"DataAssetID": "ventito"
},
{
"ID": "textus",
"Name": "Annie Stehr",
"Code": "esse",
"BaseImageURL": "quod",
"HighResImageURL": "truculenter",
"LowResImageURL": "admoneo",
"HomeLeagueID": "utor",
"TeamMemberIDs": [
"cupiditate",
"solutio"
],
"BundleID": "curo",
"BundleDataAssetID": "tametsi",
"DataAssetID": "curatio"
},
{
"ID": "suspendo",
"Name": "Santiago Abernathy",
"Code": "pecco",
"BaseImageURL": "accusator",
"HighResImageURL": "animus",
"LowResImageURL": "officiis",
"HomeLeagueID": "quo",
"TeamMemberIDs": [
"ambitus",
"alias",
"aeternus",
"sol"
],
"BundleID": "sollicito",
"BundleDataAssetID": "subito",
"DataAssetID": "repellendus"
},
{
"ID": "creo",
"Name": "Amanda Larson",
"Code": "celebrer",
"BaseImageURL": "voveo",
"HighResImageURL": "ver",
"LowResImageURL": "subnecto",
"HomeLeagueID": "tardus",
"TeamMemberIDs": [
"coma",
"demum",
"absum"
],
"BundleID": "accusator",
"BundleDataAssetID": "voluptatum",
"DataAssetID": "mollitia"
}
],
"Seasons": null,
"Splits": null
}