GET Presence
https://127.0.0.1:{port}/chat/v4/presences Get a list of online friends and their activity
If the player is playing Valorant, private is a base64-encoded JSON string that contains useful information such as party and in-progress game score.
Headers
-
Authorization: Basic {base64 encoded "riot:{lockfile password}"}
URL Parameters
-
{port}The port can be found from the lockfile (located at
%LocalAppData%\Riot Games\Riot Client\Config\lockfile) when the game is running. The file has the formatname:pid:port:password:protocol
Other Variables
-
lockfile passwordThe password can be found from the lockfile (located at
%LocalAppData%\Riot Games\Riot Client\Config\lockfile) when the game is running. The file has the formatname:pid:port:password:protocol
Response
type PresenceResponse = {
presences: {
actor?: unknown | null;
basic: string;
details?: unknown | null;
game_name: string;
game_tag: string;
location?: unknown | null;
msg?: unknown | null;
name: string;
patchline?: unknown | null;
pid: string;
platform?: unknown | null;
private: string | null;
privateJwt?: unknown | null;
product: "valorant" | "league_of_legends";
/** Player UUID */
puuid: string;
region: string;
resource: string;
state: "mobile" | "dnd" | "away" | "chat";
summary: string;
/** Milliseconds since epoch */
time: number;
}[];
}; {
"presences": [
{
"basic": "nostrum",
"game_name": "eaque",
"game_tag": "uxor",
"name": "Leigh Kiehn",
"pid": "sono",
"product": "valorant",
"puuid": "A60351A6-fBBd-0eEd-9d2B-0Fdb5dbC115B",
"region": "stillicidium",
"resource": "antiquus",
"state": "mobile",
"summary": "vitiosus",
"time": "+115218-09-05T04:08:25.700Z"
},
{
"basic": "sperno",
"game_name": "auxilium",
"game_tag": "nemo",
"name": "Caleb Wisozk",
"pid": "tepidus",
"product": "league_of_legends",
"puuid": "02DCB393-A16A-2D9c-4A3D-dfe2d3Af90F7",
"region": "callide",
"resource": "qui",
"state": "mobile",
"summary": "alii",
"time": "+098020-07-23T17:41:00.031Z"
},
{
"basic": "antiquus",
"game_name": "demergo",
"game_tag": "theologus",
"name": "Bryant Hettinger",
"pid": "temperantia",
"product": "valorant",
"puuid": "2F9C735F-dDFF-8fd1-E85e-9d8EAAAC4B34",
"region": "cetera",
"resource": "thesis",
"state": "chat",
"summary": "velociter",
"time": "+184918-12-16T02:38:08.562Z"
},
{
"basic": "acerbitas",
"game_name": "tero",
"game_tag": "super",
"name": "Eddie Will",
"pid": "dolor",
"product": "valorant",
"puuid": "42E99Fb8-34fb-aAEf-b3d1-bb9B7aCeCDde",
"region": "concido",
"resource": "creator",
"state": "dnd",
"summary": "callide",
"time": "8274-07-14T09:49:12.235Z"
},
{
"basic": "tamquam",
"game_name": "aspernatur",
"game_tag": "crustulum",
"name": "Joey Hessel",
"pid": "amo",
"product": "valorant",
"puuid": "850Deb0D-abb9-F0B8-eb9c-A25bFFbd456f",
"region": "adhuc",
"resource": "sublime",
"state": "mobile",
"summary": "carcer",
"time": "+076103-07-17T16:30:34.025Z"
}
]
}