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": "F6bFf2E6-4118-c4cb-0bA4-2BfDbB63253D",
"Version": 5666396170921070,
"Teams": [
{
"TeamID": "Blue",
"Players": [
{
"Subject": "E735F103-6981-cbbe-9EFF-35aD503BFdd1",
"CharacterID": "82AD6Bed-8b2D-7CD9-07aE-3f7bf6F6Cbd2",
"CharacterSelectionState": "locked",
"PregamePlayerState": "joined",
"CompetitiveTier": 3248375475090290,
"PlayerIdentity": {
"Subject": "7bA23010-7Fd0-14Fa-cacC-cBCD5CEcE679",
"PlayerCardID": "DA0dE6A9-f015-E4Ef-f2Be-CEeFDfF6ec9e",
"PlayerTitleID": "74B141BA-8228-7cB1-cc19-96BBeaD08a80",
"AccountLevel": 7463642054726703,
"PreferredLevelBorderID": "",
"Incognito": false,
"HideAccountLevel": false
},
"SeasonalBadgeInfo": {
"SeasonID": "",
"NumberOfWins": 2007779841204914,
"WinsByTier": null,
"Rank": 6911373786003257,
"LeaderboardRank": 1179582500548492
},
"IsCaptain": true
},
{
"Subject": "CC3DCbcb-fAeF-eeeF-d33E-0DDE4cBAe7eB",
"CharacterID": "3E0955C7-32FF-8fE2-dA1a-cD7971DD22D7",
"CharacterSelectionState": "selected",
"PregamePlayerState": "joined",
"CompetitiveTier": 7350081707391638,
"PlayerIdentity": {
"Subject": "cfbAae8c-bFeE-48Cd-50EE-4b8277FFC8c7",
"PlayerCardID": "19Fa6dB2-eEcb-8bf1-d2D8-d43BA3E17b66",
"PlayerTitleID": "31bb9b1D-dbA0-d21F-F9Eb-4e16aAEe730A",
"AccountLevel": 2367525724732576,
"PreferredLevelBorderID": "",
"Incognito": true,
"HideAccountLevel": false
},
"SeasonalBadgeInfo": {
"SeasonID": "3DC3093C-4bA7-6e67-33Ac-44C20f3EC69f",
"NumberOfWins": 1279211368396300,
"WinsByTier": null,
"Rank": 3130262928646037,
"LeaderboardRank": 4490220544704939
},
"IsCaptain": false
},
{
"Subject": "4FFd03ae-d1f5-D132-76C8-0a1A824f599f",
"CharacterID": "a2f5DA17-Dbb0-50A4-Ef4F-c70DD04ecB4D",
"CharacterSelectionState": "locked",
"PregamePlayerState": "joined",
"CompetitiveTier": 8205509440174264,
"PlayerIdentity": {
"Subject": "3b2cE6DE-85C8-B4Ba-4fA0-51db2E1DCF96",
"PlayerCardID": "E9Ca0EE1-66dF-a053-cA4a-9B536D2eCac2",
"PlayerTitleID": "e6EBb4B7-3909-ecba-2190-134A39E1eC8D",
"AccountLevel": 1779979755577565,
"PreferredLevelBorderID": "",
"Incognito": true,
"HideAccountLevel": false
},
"SeasonalBadgeInfo": {
"SeasonID": "",
"NumberOfWins": 8034402792398300,
"WinsByTier": null,
"Rank": 2860818281439239,
"LeaderboardRank": 8087842201824811
},
"IsCaptain": true
}
]
},
{
"TeamID": "Red",
"Players": [
{
"Subject": "7c5CCA2E-54B6-a72A-0c91-C0Be86b9be54",
"CharacterID": "2Dd0fbcd-C6F2-F7fB-297C-63CcA478eA10",
"CharacterSelectionState": "locked",
"PregamePlayerState": "joined",
"CompetitiveTier": 3299856491470087,
"PlayerIdentity": {
"Subject": "D0A7bE89-A685-95b7-0F07-F91414A86F26",
"PlayerCardID": "063BB251-932c-5bAe-1fAd-ab08abAaF7a3",
"PlayerTitleID": "0c63c50f-AD32-4B5d-95DF-68EED73ED005",
"AccountLevel": 926274792353193,
"PreferredLevelBorderID": "",
"Incognito": false,
"HideAccountLevel": false
},
"SeasonalBadgeInfo": {
"SeasonID": "9b56fcF6-D00e-9634-8A31-6a2EAaC70e67",
"NumberOfWins": 8916913993864764,
"WinsByTier": null,
"Rank": 4659028744241769,
"LeaderboardRank": 8203814877728819
},
"IsCaptain": false
},
{
"Subject": "fa53F43E-E600-E98F-F5d8-cc934d4a49Fa",
"CharacterID": "FFFf40fB-FA88-c081-85D9-B5A5Fb5e32eA",
"CharacterSelectionState": "selected",
"PregamePlayerState": "joined",
"CompetitiveTier": 1433244760046824,
"PlayerIdentity": {
"Subject": "c574Acab-C686-C24c-DC8B-9C3d60D8dEa6",
"PlayerCardID": "EE3F4B2C-abd4-daBE-Fe59-76A7c2b9E982",
"PlayerTitleID": "9560BCaF-8fCA-059d-93fc-6fC413eedB2b",
"AccountLevel": 3906378287161899,
"PreferredLevelBorderID": "",
"Incognito": false,
"HideAccountLevel": true
},
"SeasonalBadgeInfo": {
"SeasonID": "bDeB2cfA-50e7-7B20-c9CA-1Ef4e6F47EE6",
"NumberOfWins": 6657491096607003,
"WinsByTier": null,
"Rank": 4155364411667575,
"LeaderboardRank": 8318016559050749
},
"IsCaptain": true
}
]
}
],
"AllyTeam": {
"TeamID": "66F0b0DD-8CAE-468C-9e6a-f5e80cf139Ee",
"Players": [
{
"Subject": "9f4760F6-7Ca5-E187-Db0b-FBbFdCA5B8fB",
"CharacterID": "Eb6afCA3-09E4-F22c-1DF0-E3BD1CAe0FEd",
"CharacterSelectionState": "selected",
"PregamePlayerState": "joined",
"CompetitiveTier": 6503756514665171,
"PlayerIdentity": {
"Subject": "fA4A6663-bEFa-1Df8-CcAE-0FCEc1c4CB0b",
"PlayerCardID": "581Ff2AF-CDc5-80Bc-c7dF-94DDDc5ffDdF",
"PlayerTitleID": "95df4151-55B7-eea7-e0FD-5D0B17FceE1a",
"AccountLevel": 2195422250270412,
"PreferredLevelBorderID": "",
"Incognito": false,
"HideAccountLevel": true
},
"SeasonalBadgeInfo": {
"SeasonID": "",
"NumberOfWins": 31478287212164,
"WinsByTier": null,
"Rank": 8583791242459409,
"LeaderboardRank": 3403705759756982
},
"IsCaptain": false
},
{
"Subject": "D562F4Ac-9571-3cE9-b1a6-e824cC2FEbdB",
"CharacterID": "8a325E2a-4520-31DC-4925-fc25Da26680f",
"CharacterSelectionState": "locked",
"PregamePlayerState": "joined",
"CompetitiveTier": 4487828539660508,
"PlayerIdentity": {
"Subject": "fDebA69F-b665-dBCa-91f2-83CA2a39dCcd",
"PlayerCardID": "c1df6aA5-Be7a-aff3-DbCC-DffA416367dE",
"PlayerTitleID": "22dD2bf0-86bD-b11f-Fd1E-51D1dc64f7FE",
"AccountLevel": 7089392452728791,
"PreferredLevelBorderID": "a3acE227-4C88-a6c2-dCcb-b17bE3fB8Fda",
"Incognito": false,
"HideAccountLevel": false
},
"SeasonalBadgeInfo": {
"SeasonID": "Ab171cbd-538B-5813-d12A-Aae3288064fF",
"NumberOfWins": 8843829762089576,
"WinsByTier": null,
"Rank": 4968230733312009,
"LeaderboardRank": 5098394931199872
},
"IsCaptain": false
},
{
"Subject": "caD68FfB-7FEf-7FB7-CFE1-0d9F3cF80a0C",
"CharacterID": "72DdD68B-be4B-bf81-e9D7-bb9Cdf8E5DFD",
"CharacterSelectionState": "locked",
"PregamePlayerState": "joined",
"CompetitiveTier": 7351473675295007,
"PlayerIdentity": {
"Subject": "3dD60FBa-eeA6-97D2-d444-C8Eaf4a5bff2",
"PlayerCardID": "9CEBe504-75Fc-c1Ef-713A-7C46FBBe35d7",
"PlayerTitleID": "8c2BcaF6-30aF-fBc7-77db-bcC1Ce69FF41",
"AccountLevel": 4784590147933746,
"PreferredLevelBorderID": "",
"Incognito": false,
"HideAccountLevel": false
},
"SeasonalBadgeInfo": {
"SeasonID": "dfC79Eb4-1657-ccA2-42cA-BE73259881C8",
"NumberOfWins": 6174748939916649,
"WinsByTier": null,
"Rank": 648225558692105,
"LeaderboardRank": 1726454999103861
},
"IsCaptain": true
},
{
"Subject": "355C7c26-7d02-FBf0-1B0b-adCCeB6bdf8f",
"CharacterID": "3fCD9bAf-Ce20-Cccc-FDc8-bb773a21226E",
"CharacterSelectionState": "selected",
"PregamePlayerState": "joined",
"CompetitiveTier": 4631412105436107,
"PlayerIdentity": {
"Subject": "3722458c-3dD2-EeC4-65db-9aeDE3d7A4fC",
"PlayerCardID": "35f64BAf-9c3b-7277-dc78-F2efFDAD05ad",
"PlayerTitleID": "F8a6BC2E-Dfab-01B0-E2Aa-D49c388eb8eB",
"AccountLevel": 2250698284724963,
"PreferredLevelBorderID": "",
"Incognito": false,
"HideAccountLevel": true
},
"SeasonalBadgeInfo": {
"SeasonID": "2adC3C7C-be92-9cD3-eE77-E5bcebeEaE96",
"NumberOfWins": 8859813907502653,
"WinsByTier": null,
"Rank": 2678132029542933,
"LeaderboardRank": 2051783592881448
},
"IsCaptain": false
},
{
"Subject": "b4d212AB-FFD3-8bd3-C16B-04804Fb22ec2",
"CharacterID": "5aFfAeAd-B6ae-ecD7-c321-DF9F0B3cD1d4",
"CharacterSelectionState": "locked",
"PregamePlayerState": "joined",
"CompetitiveTier": 7503425811068516,
"PlayerIdentity": {
"Subject": "3eD7cD46-ef1B-6cDd-7a02-faFe8F23a207",
"PlayerCardID": "0AFdDBF1-59D9-aba8-C38e-3A5aD7E0C814",
"PlayerTitleID": "Dcf0FC95-30Dd-c57f-6CeF-0BabB45ccaA5",
"AccountLevel": 8468703628518249,
"PreferredLevelBorderID": "DDbEA189-90ef-428D-e3c7-a7aACC35FbC2",
"Incognito": true,
"HideAccountLevel": false
},
"SeasonalBadgeInfo": {
"SeasonID": "c5fb83dE-fE86-72D3-F236-558e28adcdC2",
"NumberOfWins": 1790054849171598,
"WinsByTier": null,
"Rank": 4112821348873258,
"LeaderboardRank": 7838394056532573
},
"IsCaptain": false
}
]
},
"EnemyTeam": {
"TeamID": "Red",
"Players": [
{
"Subject": "2C95bBBd-bfd0-1F6d-D3A5-c6FD4aD299d4",
"CharacterID": "0BfbD93D-D1e9-2De6-2d09-51BD2eAbfFC2",
"CharacterSelectionState": "",
"PregamePlayerState": "joined",
"CompetitiveTier": 7455481939721495,
"PlayerIdentity": {
"Subject": "bcebed54-EEB2-1BCA-CFAE-5b9F6AdBdfEF",
"PlayerCardID": "0fbAf7eE-24A7-D9f9-45Ff-6ab9BaeBeDeF",
"PlayerTitleID": "B67d5A9c-36aa-C6Fd-CcA3-53BA6FAC7132",
"AccountLevel": 4086511563416758,
"PreferredLevelBorderID": "",
"Incognito": true,
"HideAccountLevel": false
},
"SeasonalBadgeInfo": {
"SeasonID": "BABCeCd7-2B6F-6aA7-CCe2-E2eafE64a51b",
"NumberOfWins": 4727523543913988,
"WinsByTier": null,
"Rank": 1979621727603866,
"LeaderboardRank": 3625833212564316
},
"IsCaptain": false
},
{
"Subject": "7ADFE761-faEd-adEe-aaBb-a811Ecb7445D",
"CharacterID": "4775b317-cC44-0791-AcBC-222563EeEc2E",
"CharacterSelectionState": "",
"PregamePlayerState": "joined",
"CompetitiveTier": 3095538547431639,
"PlayerIdentity": {
"Subject": "Dbbf1C5c-cFFB-6FaD-5e3c-b4c62ccb31d2",
"PlayerCardID": "f0Efb255-3f01-7bd5-bB3a-abfeacDB2EEB",
"PlayerTitleID": "2AefC24A-CA6b-F274-0d3A-E1Ec0CcEE54C",
"AccountLevel": 6473664915254948,
"PreferredLevelBorderID": "fc19bAF7-EaDf-aC25-DCdd-AE1A1FE223c0",
"Incognito": true,
"HideAccountLevel": false
},
"SeasonalBadgeInfo": {
"SeasonID": "2b5E9B86-0000-abaa-ea52-dac3ECbacf2b",
"NumberOfWins": 6122631986300074,
"WinsByTier": null,
"Rank": 8996365620655167,
"LeaderboardRank": 4789842616230027
},
"IsCaptain": true
},
{
"Subject": "0A580192-edcf-2fAE-deAD-F42038b6bF0f",
"CharacterID": "709bF8bD-9cab-8C9B-8304-9fbd7FA16a8F",
"CharacterSelectionState": "locked",
"PregamePlayerState": "joined",
"CompetitiveTier": 2316297868863141,
"PlayerIdentity": {
"Subject": "68CadCC5-40Ae-f2f3-a38f-acDf2E0341E1",
"PlayerCardID": "C7DFdfF7-56bd-97aD-8ba5-9a764f5aE5D6",
"PlayerTitleID": "Fb3dc832-29c6-bec7-DB0A-fC1Eb9D5cdaA",
"AccountLevel": 2630368714433507,
"PreferredLevelBorderID": "D2d174dd-d8ac-C0b0-745c-8bE61968ccAC",
"Incognito": false,
"HideAccountLevel": true
},
"SeasonalBadgeInfo": {
"SeasonID": "E98C4CBD-BADD-398d-8fc7-bDabbfA5aCAf",
"NumberOfWins": 7897018449548610,
"WinsByTier": null,
"Rank": 7060347872623205,
"LeaderboardRank": 3325019946406645
},
"IsCaptain": true
},
{
"Subject": "AeBDBc7D-8dFe-c1dD-443b-733AacC5f92d",
"CharacterID": "be7CAfAe-2C7f-efc5-f7be-4dbAB9bD7Bd8",
"CharacterSelectionState": "locked",
"PregamePlayerState": "joined",
"CompetitiveTier": 5721642042584080,
"PlayerIdentity": {
"Subject": "27A0976C-ddCF-3De2-8C3F-d491B48eAD95",
"PlayerCardID": "dFaf2Adb-00Bd-F41A-3A70-ffECc4306AbC",
"PlayerTitleID": "C5BfCfCA-fbf9-3a8D-9F0C-D0D1f66e8F32",
"AccountLevel": 3339065816585982,
"PreferredLevelBorderID": "",
"Incognito": true,
"HideAccountLevel": false
},
"SeasonalBadgeInfo": {
"SeasonID": "8A19b52c-Fa1e-709e-FcB5-D96A9B2cfAef",
"NumberOfWins": 4502381741828712,
"WinsByTier": null,
"Rank": 148662151385747,
"LeaderboardRank": 7380305852208609
},
"IsCaptain": true
}
]
},
"ObserverSubjects": [
null,
null,
null,
null
],
"MatchCoaches": [
null,
null,
null,
null
],
"EnemyTeamSize": 3251027843781454,
"EnemyTeamLockCount": 2546097609263868,
"PregameState": "character_select_active",
"LastUpdated": "2026-06-05T16:42:57.266Z",
"MapID": "cena",
"MapSelectPool": [
null,
null,
null,
null
],
"BannedMapIDs": [
null
],
"MapSelectSteps": [
null,
null,
null
],
"MapSelectStep": 5736543233457496,
"Team1": "bD92beFd-F9cA-4ccE-3Cdc-829fDbAfDdbB",
"GamePodID": "solvo",
"Mode": "conitor",
"VoiceSessionID": "vobis",
"MUCName": "tot",
"TeamMatchToken": "asperiores",
"QueueID": "statua",
"ProvisioningFlowID": "Matchmaking",
"IsRanked": true,
"PhaseTimeRemainingNS": 2639304350475751,
"StepTimeRemainingNS": 4944145161767817,
"altModesFlagADA": true,
"TournamentMetadata": null,
"RosterMetadata": null
}