Player Session
Get the current session state of a player. loopState indicates what the player is currently doing — MENUS means they are in the main menu, PREGAME means they are in agent select, INGAME means they are in a match. When loopState is PREGAME or INGAME, loopStateMetadata contains the match ID that can be used with the GET Pre-Game Match or GET Current Game Match endpoints.
Headers
X-Riot-ClientPlatform string required {client platform}— Base64-encoded client platform JSON X-Riot-ClientVersion string required {client version}— The current Valorant client version X-Riot-Entitlements-JWT string required {entitlement token}— From the Entitlements Token or Entitlement endpoint Authorization string required Bearer {auth token}— From the Entitlements Token endpoint or Riot auth URL parameters
region enum required na, latam, br, eu, ap or kr.
nalatambreuapkrHow to get it
There are 6 regions:
| Region ID | Region Name |
|---|---|
na | North America |
latam | Latin America |
br | Brazil |
eu | Europe |
ap | Asia Pacific |
kr | Korea |
The region can be found in the ShooterGame log (%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.net
Use the Riot Geo endpoint with the ID and auth tokens from Cookie Reauth
shard enum required na, pbe, eu, ap or kr: depends on where the account was created.
napbeeuapkrHow to get it
The shard is dependent on where the Riot account was created.
There are 5 shards:
| Shard | Region(s) |
|---|---|
na | latam, br, na |
pbe | na |
eu | eu |
ap | ap |
kr | kr |
The shard can be found in the ShooterGame log (%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.net
The shard can be found from using a lookup table with the region. To find the region, use the Riot Geo endpoint with the ID and auth tokens from Cookie Reauth
puuid string · uuid required Other variables
client platform Base64-encoded client platform JSON. Details
A string representing the platform of the client. Base-64 encoded JSON with the following fields:
{
"platformType": "PC",
"platformOS": "Windows",
"platformOSVersion": "10.0.26200.1.256.64bit",
"platformChipset": "Unknown"
} ewoJInBsYXRmb3JtVHlwZSI6ICJQQyIsCgkicGxhdGZvcm1PUyI6ICJXaW5kb3dzIiwKCSJwbGF0Zm9ybU9TVmVyc2lvbiI6ICIxMC4wLjI2MjAwLjEuMjU2LjY0Yml0IiwKCSJwbGF0Zm9ybUNoaXBzZXQiOiAiVW5rbm93biIKfQ==
is a value that works.
client version The current Valorant client version. Details
The version of the Valorant client. This can be obtained in a number of ways:
- Parsing the ShooterGame log at
%LocalAppData%\VALORANT\Saved\Logs\ShooterGame.log - Using the Sessions endpoint
- Using the third-party RadiantConnect version endpoint (
data.riot_client_version) - Using the third-party Versions endpoint
entitlement token From the Entitlements Token or Entitlement endpoint. Details
auth token From the Entitlements Token endpoint or Riot auth. Details
Response
subject string · uuid Player UUID
cxnState string Connection state, e.g. "CONNECTED"
cxnCloseReason string clientID string · uuid UUID
clientVersion string loopState enum Current state of the player
"MENUS""PREGAME""INGAME" loopStateMetadata string Match ID when loopState is PREGAME or INGAME, empty string otherwise
version number lastHeartbeatTime string expiredTime string heartbeatIntervalMillis number playtimeNotification string playtimeMinutes number isRestricted boolean userinfoValidTime string restrictionType string clientPlatformInfo object Show nested attributes Hide nested attributes 5
platformType string platformOS string platformOSVersion string platformChipset string platformDevice string connectionTime string shouldForceInvalidate boolean