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": "baaebF4f-7a41-6E6d-Ba26-854a459cD1BE",
"Version": 8652755790523173,
"Teams": [
{
"TeamID": "a3Abd4ec-cCE9-E9eD-FC6f-3AdBFf8e024b",
"Players": [
{
"Subject": "5FbD3D35-c27c-E718-f4e9-0f2cffB7913b",
"CharacterID": "8943784B-8dcD-23Cd-AaB6-B9Ba7e1E0cFf",
"CharacterSelectionState": "",
"PregamePlayerState": "joined",
"CompetitiveTier": 308937711050849,
"PlayerIdentity": {
"Subject": "027b7f1b-7087-9f7c-ba7E-8BEb8dF67E0F",
"PlayerCardID": "F5B6Cf0f-7C8f-bbbF-aF8b-eD993BDCCeba",
"PlayerTitleID": "773Fb19B-BC63-dBE0-A4F9-FeF0F03E1A92",
"AccountLevel": 2569701594722925,
"PreferredLevelBorderID": "",
"Incognito": true,
"HideAccountLevel": false
},
"SeasonalBadgeInfo": {
"SeasonID": "60effCD4-ebBc-C01D-5AF8-EbC57D00DF07",
"NumberOfWins": 4306392196691720,
"WinsByTier": null,
"Rank": 2177240092500534,
"LeaderboardRank": 4478564610838696
},
"IsCaptain": false
},
{
"Subject": "EaA2a0C0-35fb-C97b-3b81-D8a5bAE638fa",
"CharacterID": "3dd433bD-2E4E-75aF-7A13-A8Ef8DeFc3cC",
"CharacterSelectionState": "selected",
"PregamePlayerState": "joined",
"CompetitiveTier": 8125347642053275,
"PlayerIdentity": {
"Subject": "f8A6B6ed-D1ee-eA17-19De-F4dc4f0beE7F",
"PlayerCardID": "519AEe4a-bbAf-5F5B-44e0-1EabC7B21ace",
"PlayerTitleID": "df5AA937-3Efd-09Ff-cD2d-73d951b6A51b",
"AccountLevel": 8881551355627490,
"PreferredLevelBorderID": "",
"Incognito": true,
"HideAccountLevel": false
},
"SeasonalBadgeInfo": {
"SeasonID": "",
"NumberOfWins": 8025209851645575,
"WinsByTier": null,
"Rank": 1897102218637741,
"LeaderboardRank": 6012694902863611
},
"IsCaptain": false
},
{
"Subject": "be4BE0B7-48AD-cFDC-C6bB-EC21F1702A6c",
"CharacterID": "E7229B05-0d6A-9B74-A45b-1bFc5B1ff8dF",
"CharacterSelectionState": "selected",
"PregamePlayerState": "joined",
"CompetitiveTier": 2414848796108044,
"PlayerIdentity": {
"Subject": "61bB88fa-e23b-Fa73-F63D-aa42670D7Fa4",
"PlayerCardID": "aa56A8FB-Fb7C-80d6-0610-0c46327a8fE0",
"PlayerTitleID": "fecdA0Fa-E7a1-F36e-bafa-daD7edd2B9e1",
"AccountLevel": 8251901756048824,
"PreferredLevelBorderID": "",
"Incognito": true,
"HideAccountLevel": true
},
"SeasonalBadgeInfo": {
"SeasonID": "",
"NumberOfWins": 6639074587762109,
"WinsByTier": null,
"Rank": 531898050216340,
"LeaderboardRank": 1978754178959032
},
"IsCaptain": true
},
{
"Subject": "3b8C6C96-a5Eb-1CeF-a6db-Fedf5F2be028",
"CharacterID": "668B5fEe-eaD5-f5F3-C372-fACcb5A6bcc6",
"CharacterSelectionState": "locked",
"PregamePlayerState": "joined",
"CompetitiveTier": 2181086083486448,
"PlayerIdentity": {
"Subject": "8ebA7009-E5Dc-d3e3-7755-0a6CF3cdaBd5",
"PlayerCardID": "9c605129-75e6-f3e1-ECe7-9be5D7f34D97",
"PlayerTitleID": "AF2f6AAb-5c2A-3cc4-02a7-5AE859fba26b",
"AccountLevel": 6148196923341722,
"PreferredLevelBorderID": "",
"Incognito": false,
"HideAccountLevel": false
},
"SeasonalBadgeInfo": {
"SeasonID": "babf50F1-17a8-F795-a458-b84b2dDabeea",
"NumberOfWins": 8185545302689518,
"WinsByTier": null,
"Rank": 3918984880702270,
"LeaderboardRank": 2578557701261141
},
"IsCaptain": false
},
{
"Subject": "0CEABEB7-acaC-e97C-a7ab-9276e2057FcE",
"CharacterID": "D3E4f2Ae-8d16-930F-8866-7a2F62D4bEeC",
"CharacterSelectionState": "",
"PregamePlayerState": "joined",
"CompetitiveTier": 34960197811862,
"PlayerIdentity": {
"Subject": "E19BE4ef-C7Cf-B0e1-7D6e-a88B14A86CDD",
"PlayerCardID": "54e4fb7f-0CbB-7dA5-3EE9-b8874Fb24CDD",
"PlayerTitleID": "Def2eafC-9b43-6868-eCA6-abd94EEE3874",
"AccountLevel": 1367189898490950,
"PreferredLevelBorderID": "",
"Incognito": true,
"HideAccountLevel": true
},
"SeasonalBadgeInfo": {
"SeasonID": "3bFCa0fb-feB3-F73b-e6A2-57CFeE8E6fEe",
"NumberOfWins": 8489410745878077,
"WinsByTier": null,
"Rank": 3117942532624301,
"LeaderboardRank": 5271706351479885
},
"IsCaptain": true
}
]
},
{
"TeamID": "Red",
"Players": [
{
"Subject": "dbf0Decd-a66a-fCCb-c427-e6C3ea8A3B1A",
"CharacterID": "8c96f9Bb-Aac1-d1cf-814B-d86A7ef6bc44",
"CharacterSelectionState": "selected",
"PregamePlayerState": "joined",
"CompetitiveTier": 6743585380090162,
"PlayerIdentity": {
"Subject": "bC4EE95B-78e8-Fd8D-aaB2-4F57CDE067a8",
"PlayerCardID": "5f00e585-C589-c1dC-b88B-ec3Dfcdf6109",
"PlayerTitleID": "8aDC91D9-FeBc-96Eb-dAfa-26Ca8efFA551",
"AccountLevel": 3161480692068933,
"PreferredLevelBorderID": "",
"Incognito": false,
"HideAccountLevel": true
},
"SeasonalBadgeInfo": {
"SeasonID": "",
"NumberOfWins": 8842943768252267,
"WinsByTier": null,
"Rank": 8412422144033700,
"LeaderboardRank": 1605665442937853
},
"IsCaptain": true
},
{
"Subject": "05f6c24f-deee-8EaB-24ca-bd16aed3D8aC",
"CharacterID": "Ea4a6b99-f05b-034E-4d9D-Bee953B8EB4C",
"CharacterSelectionState": "selected",
"PregamePlayerState": "joined",
"CompetitiveTier": 3133626279062739,
"PlayerIdentity": {
"Subject": "32dE7Ea9-EdBD-C31D-eef6-dfa53EA36Db0",
"PlayerCardID": "5Bb3e37e-B5b8-d6fb-6C2d-27bBF7D729bA",
"PlayerTitleID": "33bDDcBa-F21F-B082-F55f-a0AEd08737B5",
"AccountLevel": 2557236034686031,
"PreferredLevelBorderID": "",
"Incognito": false,
"HideAccountLevel": true
},
"SeasonalBadgeInfo": {
"SeasonID": "",
"NumberOfWins": 8785002504779140,
"WinsByTier": null,
"Rank": 4304645509078036,
"LeaderboardRank": 6935295940765935
},
"IsCaptain": false
},
{
"Subject": "990513cD-02Bf-Bd7B-98AC-95A9AA95aD55",
"CharacterID": "CBECBe77-0E9f-bd45-7AeA-fBEBe8a78Ce2",
"CharacterSelectionState": "",
"PregamePlayerState": "joined",
"CompetitiveTier": 2413573662852984,
"PlayerIdentity": {
"Subject": "70Bfcee7-D9b4-4F7A-C73D-AD7928c42885",
"PlayerCardID": "5e3f32DC-bf89-3EDB-d82B-6f6dce8A3bB1",
"PlayerTitleID": "8A58Bdb6-30Eb-3F3F-9ad7-4AFfD3a2393c",
"AccountLevel": 4218065387771572,
"PreferredLevelBorderID": "7a4eF01b-FdbE-ADc0-1F74-D57156cAAEA0",
"Incognito": false,
"HideAccountLevel": false
},
"SeasonalBadgeInfo": {
"SeasonID": "",
"NumberOfWins": 8022205030944896,
"WinsByTier": null,
"Rank": 7050361752005285,
"LeaderboardRank": 659381484886667
},
"IsCaptain": true
},
{
"Subject": "E95e42Be-Db9a-A50d-DEeF-d6CFcb84CaBD",
"CharacterID": "Efe53c8A-BbDd-2fEA-F4eb-c9b86bDC85cF",
"CharacterSelectionState": "locked",
"PregamePlayerState": "joined",
"CompetitiveTier": 2681292118641068,
"PlayerIdentity": {
"Subject": "359A7bdA-ae0C-627E-12aE-bebadf740C2c",
"PlayerCardID": "EFED3Bee-25C7-DFE9-CA15-2944E6fDC6c0",
"PlayerTitleID": "082f0EFd-f17E-4b31-fd54-dF225aA1A399",
"AccountLevel": 6928889948371570,
"PreferredLevelBorderID": "c6ba5Df9-9AB8-73Ac-ebcC-c8E89A36CbE4",
"Incognito": true,
"HideAccountLevel": true
},
"SeasonalBadgeInfo": {
"SeasonID": "78fF3fcf-C3D7-D2C6-5865-AE7c7c13fd05",
"NumberOfWins": 124109852854856,
"WinsByTier": null,
"Rank": 7058914571849935,
"LeaderboardRank": 3255438315715287
},
"IsCaptain": true
}
]
}
],
"AllyTeam": {
"TeamID": "Blue",
"Players": [
{
"Subject": "3b5A6d50-2D9a-Bbe8-eBB7-9227822F2Dfd",
"CharacterID": "e45Dfca1-bf3A-37da-2ddB-9dB13bF2ce10",
"CharacterSelectionState": "",
"PregamePlayerState": "joined",
"CompetitiveTier": 7940367556510241,
"PlayerIdentity": {
"Subject": "3D96Bebc-eA31-eDE2-B6de-0EcDEAE97a5D",
"PlayerCardID": "D9FEA3bB-6abA-7Aba-EBCc-5715e8832B27",
"PlayerTitleID": "e06d029a-95aD-4DcD-E6Ca-4beAb1275563",
"AccountLevel": 946403735080005,
"PreferredLevelBorderID": "5c5eD525-b763-f569-AbD8-A6a7DB76b0BD",
"Incognito": true,
"HideAccountLevel": false
},
"SeasonalBadgeInfo": {
"SeasonID": "5302Ec0c-Dc1a-c8d3-7F01-98DAD5B9Efc9",
"NumberOfWins": 6452027678403924,
"WinsByTier": null,
"Rank": 3612300364454451,
"LeaderboardRank": 5965597314684218
},
"IsCaptain": false
},
{
"Subject": "dEDbb601-2e8b-8001-b27F-aB801F34Cf77",
"CharacterID": "7BEC88DD-E0AD-bba8-Fd60-97F75F7DE99D",
"CharacterSelectionState": "selected",
"PregamePlayerState": "joined",
"CompetitiveTier": 4509477184547307,
"PlayerIdentity": {
"Subject": "bFCb5773-E44C-ee0F-E376-8F0b1A7A9Fbe",
"PlayerCardID": "1a4B3CA7-29b8-bec8-8Ff9-fAC536C49fDa",
"PlayerTitleID": "eAabEA2C-A6A2-8ADE-3f4E-aF534F8BCBAe",
"AccountLevel": 6110872988865355,
"PreferredLevelBorderID": "65299D5e-EaaB-90be-Ed41-3BF13FA1Adb7",
"Incognito": true,
"HideAccountLevel": true
},
"SeasonalBadgeInfo": {
"SeasonID": "C7eBE3DB-f1Da-B506-A115-a7bBfBefb4b3",
"NumberOfWins": 4308712405105445,
"WinsByTier": null,
"Rank": 3515847407286264,
"LeaderboardRank": 3318326873224476
},
"IsCaptain": true
},
{
"Subject": "4d6E3cbe-7AcA-4ec2-CE8A-3143e85BBEEb",
"CharacterID": "D08B5bc2-4AbE-1cA0-2bCc-fcd41dd9bEbd",
"CharacterSelectionState": "",
"PregamePlayerState": "joined",
"CompetitiveTier": 5140916194397040,
"PlayerIdentity": {
"Subject": "3eaAF3F1-3d9B-61B9-ECA2-F53f75D2198e",
"PlayerCardID": "BE4bbBa3-Cc04-6AbB-3E4E-aDc0B48bc47F",
"PlayerTitleID": "EBc4e86A-EEaE-8DAc-ffC6-F20c4c19F816",
"AccountLevel": 3420829582264525,
"PreferredLevelBorderID": "",
"Incognito": true,
"HideAccountLevel": true
},
"SeasonalBadgeInfo": {
"SeasonID": "",
"NumberOfWins": 917669969963586,
"WinsByTier": null,
"Rank": 7889029655679936,
"LeaderboardRank": 4866122252654454
},
"IsCaptain": true
},
{
"Subject": "ad46fDBa-98eA-4F7d-16dC-08d6f6f7f08B",
"CharacterID": "4CAE0E05-0fD3-Cdea-eD59-7999BEE90dd6",
"CharacterSelectionState": "selected",
"PregamePlayerState": "joined",
"CompetitiveTier": 5800462544582935,
"PlayerIdentity": {
"Subject": "eAb592Ec-9f26-e842-9426-Cefa0C088423",
"PlayerCardID": "Bb29CBf6-6b23-01FD-8AAf-E5d303d3Ac7E",
"PlayerTitleID": "ED3E38d6-aD8E-c03B-4BAa-0a0EBf60D6D6",
"AccountLevel": 255557432218331,
"PreferredLevelBorderID": "0f2d98Da-a240-b4eB-Fbd7-F984FEcFcDA4",
"Incognito": false,
"HideAccountLevel": false
},
"SeasonalBadgeInfo": {
"SeasonID": "8169815f-a9b0-2abf-C698-4B79FD6eebD1",
"NumberOfWins": 775284971886085,
"WinsByTier": null,
"Rank": 3728423962742347,
"LeaderboardRank": 3075911675707255
},
"IsCaptain": false
}
]
},
"EnemyTeam": {
"TeamID": "Red",
"Players": [
{
"Subject": "CFe9A651-caaC-b559-386D-13A821fC72a3",
"CharacterID": "FE9cBd6a-D9E4-bAFe-fD5B-FbD5c7563523",
"CharacterSelectionState": "locked",
"PregamePlayerState": "joined",
"CompetitiveTier": 2806804247046526,
"PlayerIdentity": {
"Subject": "73aF69DF-42ac-bbc1-ABcA-eaddd4622bBf",
"PlayerCardID": "ECFCf1Db-7D16-8F47-FEDf-CD3B1913ea16",
"PlayerTitleID": "666dBB7E-BA37-D93b-dcbC-DFcCB3b46A2A",
"AccountLevel": 3647681084120575,
"PreferredLevelBorderID": "",
"Incognito": false,
"HideAccountLevel": true
},
"SeasonalBadgeInfo": {
"SeasonID": "7170ee4E-A6CA-cb0B-F31B-8bAc18fD5479",
"NumberOfWins": 7596692609089065,
"WinsByTier": null,
"Rank": 7854973232012453,
"LeaderboardRank": 7619095508199657
},
"IsCaptain": true
}
]
},
"ObserverSubjects": [
null,
null,
null,
null,
null
],
"MatchCoaches": [
null,
null
],
"EnemyTeamSize": 185197418160728,
"EnemyTeamLockCount": 2041674985094389,
"PregameState": "character_select_active",
"LastUpdated": "2026-06-08T01:26:48.582Z",
"MapID": "ea",
"MapSelectPool": [
null
],
"BannedMapIDs": [
null,
null,
null,
null,
null
],
"MapSelectSteps": [
null
],
"MapSelectStep": 5600165942415919,
"Team1": "Red",
"GamePodID": "valde",
"Mode": "abstergo",
"VoiceSessionID": "quisquam",
"MUCName": "coerceo",
"TeamMatchToken": "clamo",
"QueueID": "allatus",
"ProvisioningFlowID": "CustomGame",
"IsRanked": true,
"PhaseTimeRemainingNS": 1707227537399759,
"StepTimeRemainingNS": 6456167764647205,
"altModesFlagADA": false,
"TournamentMetadata": null,
"RosterMetadata": null
}