GET Pre-Game Match
https://glz-{region}-1.{shard}.a.pvp.net/pregame/v1/matches/{pre-game match id} Get Pre-Game match data
Headers
-
X-Riot-ClientPlatform: {client platform} -
X-Riot-ClientVersion: {client version} -
X-Riot-Entitlements-JWT: {entitlement token} -
Authorization: Bearer {auth token}
URL Parameters
-
{region}There are 6 regions:
Obtaining locally:Region ID Region Name naNorth America latamLatin America brBrazil euEurope apAsia Pacific krKorea The region can be found in the ShooterGame log (
Obtaining remotely:%LocalAppData%\VALORANT\Saved\Logs\ShooterGame.log) when it's used in an endpoint url.
Example regex capturing region and shard:https://glz-(.+?)-1.(.+?).a.pvp.netUse the Riot Geo endpoint with the ID and auth tokens from Cookie Reauth
-
{pre-game match id}The match ID of the pre-game lobby. The ID of the pre-game lobby can be found from the Pre-Game Player endpoint.
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 Pre-GameMatchResponse = {
/** Pre-Game Match ID */
ID: string;
Version: number;
Teams: {
TeamID: ("Blue" | "Red") | string;
Players: {
/** Player UUID */
Subject: string;
/** Character ID */
CharacterID: string;
CharacterSelectionState: "" | "selected" | "locked";
PregamePlayerState: "joined";
CompetitiveTier: number;
PlayerIdentity: {
/** Player UUID */
Subject: string;
/** Card ID */
PlayerCardID: string;
/** Title ID */
PlayerTitleID: string;
AccountLevel: number;
/** Preferred Level Border ID */
PreferredLevelBorderID: string | "";
Incognito: boolean;
HideAccountLevel: boolean;
};
SeasonalBadgeInfo: {
/** Season ID */
SeasonID: string | "";
NumberOfWins: number;
WinsByTier: null;
Rank: number;
LeaderboardRank: number;
};
IsCaptain: boolean;
}[];
}[];
AllyTeam: {
TeamID: ("Blue" | "Red") | string;
Players: {
/** Player UUID */
Subject: string;
/** Character ID */
CharacterID: string;
CharacterSelectionState: "" | "selected" | "locked";
PregamePlayerState: "joined";
CompetitiveTier: number;
PlayerIdentity: {
/** Player UUID */
Subject: string;
/** Card ID */
PlayerCardID: string;
/** Title ID */
PlayerTitleID: string;
AccountLevel: number;
/** Preferred Level Border ID */
PreferredLevelBorderID: string | "";
Incognito: boolean;
HideAccountLevel: boolean;
};
SeasonalBadgeInfo: {
/** Season ID */
SeasonID: string | "";
NumberOfWins: number;
WinsByTier: null;
Rank: number;
LeaderboardRank: number;
};
IsCaptain: boolean;
}[];
} | null;
EnemyTeam: {
TeamID: ("Blue" | "Red") | string;
Players: {
/** Player UUID */
Subject: string;
/** Character ID */
CharacterID: string;
CharacterSelectionState: "" | "selected" | "locked";
PregamePlayerState: "joined";
CompetitiveTier: number;
PlayerIdentity: {
/** Player UUID */
Subject: string;
/** Card ID */
PlayerCardID: string;
/** Title ID */
PlayerTitleID: string;
AccountLevel: number;
/** Preferred Level Border ID */
PreferredLevelBorderID: string | "";
Incognito: boolean;
HideAccountLevel: boolean;
};
SeasonalBadgeInfo: {
/** Season ID */
SeasonID: string | "";
NumberOfWins: number;
WinsByTier: null;
Rank: number;
LeaderboardRank: number;
};
IsCaptain: boolean;
}[];
} | null;
ObserverSubjects: unknown[];
MatchCoaches: unknown[];
EnemyTeamSize: number;
EnemyTeamLockCount: number;
PregameState: "character_select_active" | "provisioned";
/** Date in ISO 8601 format */
LastUpdated: string;
/** Map ID */
MapID: string;
MapSelectPool: unknown[];
BannedMapIDs: unknown[];
CastedVotes?: unknown;
MapSelectSteps: unknown[];
MapSelectStep: number;
Team1: ("Blue" | "Red") | string;
GamePodID: string;
/** Game Mode */
Mode: string;
VoiceSessionID: string;
MUCName: string;
/** JWT containing match ID and player IDs */
TeamMatchToken: string;
/** Queue ID */
QueueID: string | "";
ProvisioningFlowID: "Matchmaking" | "CustomGame";
IsRanked: boolean;
PhaseTimeRemainingNS: number;
StepTimeRemainingNS: number;
altModesFlagADA: boolean;
TournamentMetadata: null;
RosterMetadata: null;
}; {
"ID": "eD641bED-CaCe-Aa53-71ec-77A4F8f9b3B7",
"Version": 5206377296744522,
"Teams": [
{
"TeamID": "8af2BBfE-C01C-c25e-7EEe-9CA52cB16d6B",
"Players": [
{
"Subject": "B3f974eb-3dDb-cbEa-6F6E-0c5E8E6E6cad",
"CharacterID": "3d9C5Bd0-6C27-6e1a-AAab-1a0B0ec638C4",
"CharacterSelectionState": "selected",
"PregamePlayerState": "joined",
"CompetitiveTier": 4699977526254901,
"PlayerIdentity": {
"Subject": "6dbCAc6C-Cc7b-EB35-3Ef8-D69cdddA3FfD",
"PlayerCardID": "ADCd6bB6-8FfE-C6fE-ECcb-Cf09D2eEDeAe",
"PlayerTitleID": "E30456eD-fDbc-1bdd-AD8d-d9B6EfAaB3f3",
"AccountLevel": 2431627258604493,
"PreferredLevelBorderID": "",
"Incognito": true,
"HideAccountLevel": true
},
"SeasonalBadgeInfo": {
"SeasonID": "",
"NumberOfWins": 8113384166114995,
"WinsByTier": null,
"Rank": 3626423321956028,
"LeaderboardRank": 3475165166486021
},
"IsCaptain": false
},
{
"Subject": "A5512D0E-4F9c-4EDF-Baa3-A20f5e0BbEde",
"CharacterID": "fC9BF8Be-a0A1-F1D1-f6Fe-F74145FCE2c7",
"CharacterSelectionState": "locked",
"PregamePlayerState": "joined",
"CompetitiveTier": 4263236571516944,
"PlayerIdentity": {
"Subject": "ecd8ddc6-4D0F-1AEd-d8ed-DeFFdc45ab46",
"PlayerCardID": "8cC92FCc-bdce-AA8E-f17C-8fcaEEFf7FAA",
"PlayerTitleID": "6EF18c6c-b107-E433-27D1-4f09dbD7AeBC",
"AccountLevel": 3748669947554565,
"PreferredLevelBorderID": "858B4eBD-abFa-aF4B-5726-Cc7079C2bA0a",
"Incognito": false,
"HideAccountLevel": false
},
"SeasonalBadgeInfo": {
"SeasonID": "4Bbb83BE-017D-13cf-EA9C-7de8b8bAED91",
"NumberOfWins": 5502932789215752,
"WinsByTier": null,
"Rank": 2310292239578398,
"LeaderboardRank": 2464078388889299
},
"IsCaptain": true
},
{
"Subject": "C8e39beE-eb2c-7BCB-eBFB-DABbB60aD3dC",
"CharacterID": "e07c1aB5-b70d-D3D1-857B-c1A6d6d0C1ec",
"CharacterSelectionState": "",
"PregamePlayerState": "joined",
"CompetitiveTier": 6811673055037655,
"PlayerIdentity": {
"Subject": "eaBF7160-558e-52AD-AA3c-1d6E596EDc83",
"PlayerCardID": "1d5dD6fD-1b1E-6829-F2B8-B93671276fc7",
"PlayerTitleID": "E9BB76c0-9b05-Ae8f-fC81-eCb63B3b1341",
"AccountLevel": 1649048364086326,
"PreferredLevelBorderID": "bf1FF58d-270b-e497-CACe-7994ce4aFBae",
"Incognito": false,
"HideAccountLevel": false
},
"SeasonalBadgeInfo": {
"SeasonID": "c174BbdD-7bBE-6a2d-C4Ae-49B02EeabEe2",
"NumberOfWins": 651843002294888,
"WinsByTier": null,
"Rank": 5645833635182566,
"LeaderboardRank": 8653046635299141
},
"IsCaptain": true
},
{
"Subject": "392d5bf5-e480-7fBe-bDb0-4dbFcdC5DC86",
"CharacterID": "BAC4B6da-01Ba-2dCA-18b4-9B63A64e9F7E",
"CharacterSelectionState": "locked",
"PregamePlayerState": "joined",
"CompetitiveTier": 4810399891771663,
"PlayerIdentity": {
"Subject": "55AC2DC2-bf1E-9a6b-Cf21-3F1beaFc1F4E",
"PlayerCardID": "92Af9d07-9CDB-DCfA-aAA8-a404f2fdbe23",
"PlayerTitleID": "dD4f2df7-90c3-2e98-bf32-4e0fA2f71122",
"AccountLevel": 1379990374463694,
"PreferredLevelBorderID": "",
"Incognito": false,
"HideAccountLevel": false
},
"SeasonalBadgeInfo": {
"SeasonID": "87A03a2B-eebB-06C6-8FdE-d7fE40f5dD9F",
"NumberOfWins": 902436955260303,
"WinsByTier": null,
"Rank": 7765334914145080,
"LeaderboardRank": 1018348505862150
},
"IsCaptain": true
},
{
"Subject": "57dc0EbF-C091-7803-7bb4-8B12Dcb6EEFa",
"CharacterID": "Bf458303-ccc0-eDB9-6F6C-a0aEcbf1fe27",
"CharacterSelectionState": "selected",
"PregamePlayerState": "joined",
"CompetitiveTier": 2305918303941701,
"PlayerIdentity": {
"Subject": "6a7fE7DB-Ba8a-B94e-DeDf-BC5BaAa56D4D",
"PlayerCardID": "a8FD66C8-a96c-7C78-AB86-eD1e46C069Af",
"PlayerTitleID": "dAaE7053-BC65-B9Cc-CBa4-a203c330fAA7",
"AccountLevel": 8217379540152096,
"PreferredLevelBorderID": "",
"Incognito": false,
"HideAccountLevel": false
},
"SeasonalBadgeInfo": {
"SeasonID": "48fAE685-1Bdc-0Ca0-5Dc7-54a44c997044",
"NumberOfWins": 3361555701204774,
"WinsByTier": null,
"Rank": 1199801290528724,
"LeaderboardRank": 3335836897496554
},
"IsCaptain": true
}
]
},
{
"TeamID": "D45Ca7A0-0AFa-1dda-03A8-2a19fcb365BB",
"Players": [
{
"Subject": "4F56f445-Ba29-CE6F-dbDE-B7Ba2e11042B",
"CharacterID": "35fE5Dde-c1E6-FCaC-3e80-FBcc4E6e25B2",
"CharacterSelectionState": "selected",
"PregamePlayerState": "joined",
"CompetitiveTier": 6811634448101324,
"PlayerIdentity": {
"Subject": "5Bab7ab5-005F-CeeA-65B5-B7d9E3A80bFc",
"PlayerCardID": "d42A702f-C6ec-Bc98-1C3B-EAbd173eF50E",
"PlayerTitleID": "9AE2860f-C6Ea-Dc2D-66AE-Dfd79dE1A82d",
"AccountLevel": 5862715069631655,
"PreferredLevelBorderID": "",
"Incognito": false,
"HideAccountLevel": true
},
"SeasonalBadgeInfo": {
"SeasonID": "95AAeA00-DF9D-0fBb-EC4b-8007d2EFf367",
"NumberOfWins": 805918667021752,
"WinsByTier": null,
"Rank": 8702134752901126,
"LeaderboardRank": 2353168100418419
},
"IsCaptain": false
},
{
"Subject": "f8BD5e2B-2E5C-791c-C2fD-DbcCe46BfB38",
"CharacterID": "d09fCBCE-a4f5-5A28-05fD-D1E4e7EccDAf",
"CharacterSelectionState": "selected",
"PregamePlayerState": "joined",
"CompetitiveTier": 6910210547473392,
"PlayerIdentity": {
"Subject": "7Ee1b15E-f5Ac-FD4e-2Fc9-17AaE5C64Fa6",
"PlayerCardID": "fD1b0d4D-e9e5-3C0C-8C73-8AaaF1DBacCE",
"PlayerTitleID": "31D37B4e-A80C-Dbed-6544-77F91A0bDA02",
"AccountLevel": 6926850065418492,
"PreferredLevelBorderID": "E5C02b4d-1F7C-aBb3-8f37-a8CAd1F9F5C1",
"Incognito": true,
"HideAccountLevel": false
},
"SeasonalBadgeInfo": {
"SeasonID": "dC4A1485-EA7E-9E5B-3d83-07Aea9b1Eebe",
"NumberOfWins": 2129470585016946,
"WinsByTier": null,
"Rank": 5869605884357379,
"LeaderboardRank": 8680611075274128
},
"IsCaptain": false
},
{
"Subject": "acD6f6FC-3cEC-17B7-Be22-eEE7CABC9EE0",
"CharacterID": "279FB705-6Afc-a6Ab-3490-ED2F6528B639",
"CharacterSelectionState": "selected",
"PregamePlayerState": "joined",
"CompetitiveTier": 6625328294889371,
"PlayerIdentity": {
"Subject": "c0Be0494-3d2f-f6d1-32Ff-b2151ec249f0",
"PlayerCardID": "9E4EDca7-aD41-0899-c79A-E39b41Aa6aFD",
"PlayerTitleID": "bC9CCeee-0eb2-4bce-fbf6-77eEE9eE9Ad7",
"AccountLevel": 8477577894128204,
"PreferredLevelBorderID": "7df9aA01-D1ee-cA2d-BD8F-6a40c61F0bb1",
"Incognito": true,
"HideAccountLevel": false
},
"SeasonalBadgeInfo": {
"SeasonID": "C79be2ab-Ead0-3b09-f0c7-ed058365a654",
"NumberOfWins": 6750897489871064,
"WinsByTier": null,
"Rank": 1556636902920129,
"LeaderboardRank": 2006328336198046
},
"IsCaptain": true
},
{
"Subject": "d5F2314D-6b8A-5aB1-F071-0CBaE4E1Abc0",
"CharacterID": "bFb1D5db-9A9A-b98c-F619-A26CE3DacC5b",
"CharacterSelectionState": "selected",
"PregamePlayerState": "joined",
"CompetitiveTier": 3570880696362244,
"PlayerIdentity": {
"Subject": "6eA7b20c-3fcf-a0b8-b2c2-c64d9433fEE0",
"PlayerCardID": "Ffb5d903-b46b-b28b-514F-d7D0FABFacff",
"PlayerTitleID": "613adEe9-537e-3B3c-ed91-DddC07cEe2f7",
"AccountLevel": 8542926281385486,
"PreferredLevelBorderID": "",
"Incognito": false,
"HideAccountLevel": false
},
"SeasonalBadgeInfo": {
"SeasonID": "",
"NumberOfWins": 8427203063442500,
"WinsByTier": null,
"Rank": 2850211751398068,
"LeaderboardRank": 5048466509451465
},
"IsCaptain": true
}
]
},
{
"TeamID": "Red",
"Players": [
{
"Subject": "B9CC76b9-0F2d-bEe1-1Dc1-aBdE76AE9D26",
"CharacterID": "0E1cA0da-398c-313e-B04A-fF737e7BAaDA",
"CharacterSelectionState": "locked",
"PregamePlayerState": "joined",
"CompetitiveTier": 4857382647394150,
"PlayerIdentity": {
"Subject": "8aaeffB9-AC02-7c38-1f9C-4275D37BBCda",
"PlayerCardID": "5E3C4Afa-d1e0-1332-286D-b5CdCaED5bFf",
"PlayerTitleID": "C4a11bb2-B785-6E8c-7659-655E7dB709D9",
"AccountLevel": 2657133980274830,
"PreferredLevelBorderID": "cCE5A079-c8B2-E11c-bEa6-3e1a0Cd7B2c5",
"Incognito": true,
"HideAccountLevel": true
},
"SeasonalBadgeInfo": {
"SeasonID": "89bE2e4c-B084-FBd7-A41d-021DFBbDBaBb",
"NumberOfWins": 2022962637068198,
"WinsByTier": null,
"Rank": 4241737968020343,
"LeaderboardRank": 5632955780213008
},
"IsCaptain": false
},
{
"Subject": "edfD0aC2-eB8c-A873-de6e-656F1fA76D59",
"CharacterID": "Eedd5f19-5fF9-eC20-8e58-7915B9eB2a0a",
"CharacterSelectionState": "",
"PregamePlayerState": "joined",
"CompetitiveTier": 5136106069471304,
"PlayerIdentity": {
"Subject": "1e42d03B-ABb6-0c0e-71BB-5470FEe1d155",
"PlayerCardID": "7Bc4c50E-a6E8-C1c4-E2AF-2AEc2aFAA6C8",
"PlayerTitleID": "cba8CbC7-a10D-FDc1-Eb72-26ECbb3dc363",
"AccountLevel": 7708317087230386,
"PreferredLevelBorderID": "",
"Incognito": true,
"HideAccountLevel": true
},
"SeasonalBadgeInfo": {
"SeasonID": "",
"NumberOfWins": 6354606874719120,
"WinsByTier": null,
"Rank": 2665289123915911,
"LeaderboardRank": 2797915887230868
},
"IsCaptain": false
}
]
}
],
"AllyTeam": {
"TeamID": "d4d69946-52D5-435E-Bf2A-d9D93AcdcCCe",
"Players": [
{
"Subject": "cD7dE2B6-cBed-F0fD-E09D-f0DDc22cA348",
"CharacterID": "C58bF478-fD3D-8223-EDFd-DDa9430a7aFF",
"CharacterSelectionState": "selected",
"PregamePlayerState": "joined",
"CompetitiveTier": 1379094108208852,
"PlayerIdentity": {
"Subject": "472a51aE-b9b3-bE23-7408-bC71EFCbb3Bd",
"PlayerCardID": "876F1893-B799-9E04-CD3D-cbE709AbA88B",
"PlayerTitleID": "0De8e3C2-df4d-BdAd-Bc91-5B7ff83e0CF7",
"AccountLevel": 2263114618109788,
"PreferredLevelBorderID": "",
"Incognito": true,
"HideAccountLevel": false
},
"SeasonalBadgeInfo": {
"SeasonID": "",
"NumberOfWins": 6793037300149974,
"WinsByTier": null,
"Rank": 7042084081327624,
"LeaderboardRank": 5960312658966386
},
"IsCaptain": false
},
{
"Subject": "80d3EFd1-821C-9e8d-7EEd-7FbF02578eEd",
"CharacterID": "09BfDc18-cE4E-597f-0c23-bc3DAb9EaddB",
"CharacterSelectionState": "",
"PregamePlayerState": "joined",
"CompetitiveTier": 7469450119037078,
"PlayerIdentity": {
"Subject": "5E0fC9E9-712d-9C1c-8eD5-30CaDA2cFa80",
"PlayerCardID": "420cDc38-16Bf-1DA2-DD8f-9aa8F48FeE6b",
"PlayerTitleID": "c4A873Ae-0dFd-6488-4a2a-cDa51C2B053c",
"AccountLevel": 2430073782366444,
"PreferredLevelBorderID": "",
"Incognito": false,
"HideAccountLevel": false
},
"SeasonalBadgeInfo": {
"SeasonID": "",
"NumberOfWins": 7437777225998801,
"WinsByTier": null,
"Rank": 4918747304465190,
"LeaderboardRank": 5216064348792223
},
"IsCaptain": true
}
]
},
"EnemyTeam": {
"TeamID": "Red",
"Players": [
{
"Subject": "Ec4BfcD1-5a29-2A7E-F09e-D65BFDE524aD",
"CharacterID": "dCe98Da9-ccdE-6bba-8ABE-cA9be0ADDD1d",
"CharacterSelectionState": "",
"PregamePlayerState": "joined",
"CompetitiveTier": 4070934229094692,
"PlayerIdentity": {
"Subject": "FAcbB555-ddDE-5de2-0Bd9-2e2C1F5Ef008",
"PlayerCardID": "3eeE4a6D-Bf36-4FF7-A1D0-bEacB1bbdA4c",
"PlayerTitleID": "1cC95ce7-aCab-B5DC-8059-53EAcAAB84Ae",
"AccountLevel": 3561398605297935,
"PreferredLevelBorderID": "bEfc6507-1183-d3B4-cbEa-BBacCa744f5a",
"Incognito": false,
"HideAccountLevel": true
},
"SeasonalBadgeInfo": {
"SeasonID": "deB4B57E-abE6-1e16-4D36-BDE2EbdddD7d",
"NumberOfWins": 1319245134988912,
"WinsByTier": null,
"Rank": 4014791688786913,
"LeaderboardRank": 3569166140223935
},
"IsCaptain": false
},
{
"Subject": "a95F44ad-F3dd-E76E-2143-3D61A7A146A0",
"CharacterID": "d33Fe79b-Db56-fBd8-eBab-697afe73DA28",
"CharacterSelectionState": "selected",
"PregamePlayerState": "joined",
"CompetitiveTier": 653694598041674,
"PlayerIdentity": {
"Subject": "f3b4ea71-160e-E781-BdDf-646cAa0B3CAf",
"PlayerCardID": "b60Afe2C-4772-91Fc-eF5E-A3cecAc5Db6e",
"PlayerTitleID": "3EE141fd-Cfbf-c863-FDfd-6B3229F02596",
"AccountLevel": 1916061249946827,
"PreferredLevelBorderID": "",
"Incognito": true,
"HideAccountLevel": true
},
"SeasonalBadgeInfo": {
"SeasonID": "",
"NumberOfWins": 8761633403264456,
"WinsByTier": null,
"Rank": 3228362293999339,
"LeaderboardRank": 5308111967521911
},
"IsCaptain": false
}
]
},
"ObserverSubjects": [
null,
null,
null,
null,
null
],
"MatchCoaches": [
null,
null,
null
],
"EnemyTeamSize": 6042842909708349,
"EnemyTeamLockCount": 1892012841035302,
"PregameState": "character_select_active",
"LastUpdated": "2026-09-29T17:43:03.143Z",
"MapID": "comptus",
"MapSelectPool": [
null,
null,
null
],
"BannedMapIDs": [
null,
null
],
"MapSelectSteps": [
null,
null,
null,
null,
null
],
"MapSelectStep": 8275122634591565,
"Team1": "EdecEA24-B56D-5aa2-c5F4-bEf4DaCb9BE9",
"GamePodID": "conor",
"Mode": "tepidus",
"VoiceSessionID": "abutor",
"MUCName": "animadverto",
"TeamMatchToken": "incidunt",
"QueueID": "",
"ProvisioningFlowID": "CustomGame",
"IsRanked": false,
"PhaseTimeRemainingNS": 8772757500764022,
"StepTimeRemainingNS": 1399355150987183,
"altModesFlagADA": false,
"TournamentMetadata": null,
"RosterMetadata": null
}