POST Matches
https://pd.{shard}.a.pvp.net/esports-service/v2/matches?locale={locale}&sport={sport} Get esports match details by match IDs.
Headers
-
X-Riot-Entitlements-JWT: {entitlement token} -
Authorization: Bearer {auth token}
URL Parameters
Query Parameters
-
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
Body
type MatchesBody = {
/** List of match IDs to fetch */
MATCHIDS: string[];
}; {
"MATCHIDS": [
"articulus",
"confugo"
]
} Response
type MatchesResponse = {
Matches: {
ID: string;
LeagueID: string;
TournamentID: string;
StageID: string;
StageName: string;
StructuralID: string;
/** ISO 8601 date string */
StartTime: string;
/** e.g. "unstarted", "inprogress", "completed" */
State: string;
/** Map of outcome ("Win", "Loss") to destination */
Destinations: {
[x: string]: {
StructuralID: string;
/** e.g. "decisionPoint", "standing" */
Type: string;
Slot: number;
};
};
MatchTeams: {
TeamID: string;
OriginStructuralID: string;
OriginType: string;
OriginSlot: number;
/** e.g. "win", "loss", or empty string if unstarted */
Result: string;
GameWins: number;
}[];
Streams: unknown[];
}[];
}; {
"Matches": [
{
"ID": "aptus",
"LeagueID": "dignissimos",
"TournamentID": "spiculum",
"StageID": "conqueror",
"StageName": "ducimus",
"StructuralID": "vester",
"StartTime": "summa",
"State": "tribuo",
"Destinations": {
"animi": {
"StructuralID": "absconditus",
"Type": "atrox",
"Slot": 4678501552067880
}
},
"MatchTeams": [
{
"TeamID": "benevolentia",
"OriginStructuralID": "tripudio",
"OriginType": "tenax",
"OriginSlot": 2430361321435208,
"Result": "cado",
"GameWins": 1853865455085908
}
],
"Streams": [
null
]
},
{
"ID": "debitis",
"LeagueID": "substantia",
"TournamentID": "vehemens",
"StageID": "deprimo",
"StageName": "quo",
"StructuralID": "victoria",
"StartTime": "nobis",
"State": "infit",
"Destinations": {
"statim": {
"StructuralID": "vicissitudo",
"Type": "defetiscor",
"Slot": 6956668573303332
}
},
"MatchTeams": [
{
"TeamID": "reiciendis",
"OriginStructuralID": "colo",
"OriginType": "celo",
"OriginSlot": 6357893237651761,
"Result": "deludo",
"GameWins": 4818316196199530
},
{
"TeamID": "degero",
"OriginStructuralID": "solvo",
"OriginType": "debeo",
"OriginSlot": 1773140153302934,
"Result": "tardus",
"GameWins": 979150843473026
},
{
"TeamID": "tabernus",
"OriginStructuralID": "admitto",
"OriginType": "dolores",
"OriginSlot": 6102801964313142,
"Result": "aequitas",
"GameWins": 3802316208419613
},
{
"TeamID": "adstringo",
"OriginStructuralID": "caelum",
"OriginType": "clamo",
"OriginSlot": 2426176471885869,
"Result": "cultura",
"GameWins": 4774952993802474
},
{
"TeamID": "dedecor",
"OriginStructuralID": "communis",
"OriginType": "voluptatum",
"OriginSlot": 9003603696931662,
"Result": "tubineus",
"GameWins": 2448919838197090
}
],
"Streams": [
null,
null
]
},
{
"ID": "defungo",
"LeagueID": "trans",
"TournamentID": "maiores",
"StageID": "appello",
"StageName": "delicate",
"StructuralID": "asperiores",
"StartTime": "ter",
"State": "rerum",
"Destinations": {
"tremo": {
"StructuralID": "aegrus",
"Type": "abscido",
"Slot": 6271028845721094
}
},
"MatchTeams": [
{
"TeamID": "aequitas",
"OriginStructuralID": "caelum",
"OriginType": "cunae",
"OriginSlot": 1922315179465622,
"Result": "utor",
"GameWins": 4467670921531658
},
{
"TeamID": "angelus",
"OriginStructuralID": "celebrer",
"OriginType": "dens",
"OriginSlot": 6087080293420134,
"Result": "carbo",
"GameWins": 839725168957228
},
{
"TeamID": "tutamen",
"OriginStructuralID": "sollicito",
"OriginType": "cerno",
"OriginSlot": 1901842256239271,
"Result": "earum",
"GameWins": 8661899967994301
},
{
"TeamID": "centum",
"OriginStructuralID": "cupiditate",
"OriginType": "eaque",
"OriginSlot": 2753398674508364,
"Result": "tondeo",
"GameWins": 8922824542546568
},
{
"TeamID": "corrupti",
"OriginStructuralID": "verbum",
"OriginType": "depereo",
"OriginSlot": 7443758964657234,
"Result": "repellat",
"GameWins": 7070216723585868
}
],
"Streams": [
null,
null,
null
]
},
{
"ID": "nostrum",
"LeagueID": "aestivus",
"TournamentID": "territo",
"StageID": "verto",
"StageName": "sordeo",
"StructuralID": "quidem",
"StartTime": "video",
"State": "architecto",
"Destinations": {
"reprehenderit": {
"StructuralID": "tempora",
"Type": "reiciendis",
"Slot": 37765024365851
}
},
"MatchTeams": [
{
"TeamID": "via",
"OriginStructuralID": "colo",
"OriginType": "derideo",
"OriginSlot": 7516291569641397,
"Result": "voluptas",
"GameWins": 2570938708068200
},
{
"TeamID": "volup",
"OriginStructuralID": "abutor",
"OriginType": "ustulo",
"OriginSlot": 4124379881613191,
"Result": "conforto",
"GameWins": 7482239364225760
}
],
"Streams": [
null,
null,
null,
null
]
}
]
}