GET Chat History

https://127.0.0.1:{port}/chat/v6/messages?cid={cid}

Get chat history for all conversations or a specific conversation if the cid is provided

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 format name:pid:port:password:protocol

Query Parameters

cid optional

A chat conversation ID. The IDs of all active conversations can be found from the All Chat Info endpoint.

Other Variables

lockfile password

The 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 format name:pid:port:password:protocol

Response

type ChatHistoryResponse = {
    messages: {
        body: string;
        cid: string;
        game_name: string;
        game_tag: string;
        id: string;
        mid: string;
        name: string;
        pid: string;
        /** Player UUID */
        puuid: string;
        read: boolean;
        region: string;
        /** Time in milliseconds since epoch */
        time: string;
        type: "chat" | "groupchat";
    }[];
};

{
  "messages": [
    {
      "body": "abutor",
      "cid": "tot",
      "game_name": "tergum",
      "game_tag": "unus",
      "id": "trucido",
      "mid": "dedecor",
      "name": "Gary Runolfsdottir",
      "pid": "ars",
      "puuid": "aeF6aAD2-0bB0-CF93-46fe-379daeDE91A1",
      "read": false,
      "region": "vigor",
      "time": null,
      "type": "groupchat"
    },
    {
      "body": "tantum",
      "cid": "suffoco",
      "game_name": "tumultus",
      "game_tag": "depulso",
      "id": "sequi",
      "mid": "cunae",
      "name": "Dr. Walter Veum",
      "pid": "nam",
      "puuid": "C4a0d2Fa-AeB2-aac6-5a79-765Ddf4eaAAd",
      "read": true,
      "region": "deleniti",
      "time": null,
      "type": "groupchat"
    },
    {
      "body": "tyrannus",
      "cid": "blandior",
      "game_name": "debilito",
      "game_tag": "terra",
      "id": "defessus",
      "mid": "cunae",
      "name": "Dianne Littel-Schumm",
      "pid": "suus",
      "puuid": "9D190ABC-D020-8Cef-9Cc8-947Ce3b2fd0e",
      "read": true,
      "region": "aedificium",
      "time": null,
      "type": "groupchat"
    },
    {
      "body": "terreo",
      "cid": "cuppedia",
      "game_name": "conculco",
      "game_tag": "voveo",
      "id": "curo",
      "mid": "totus",
      "name": "Ted Nicolas-Bailey",
      "pid": "bellum",
      "puuid": "C6b422C5-815a-9a21-d77c-e4463C42EFCC",
      "read": true,
      "region": "aranea",
      "time": null,
      "type": "chat"
    },
    {
      "body": "careo",
      "cid": "absconditus",
      "game_name": "porro",
      "game_tag": "vesper",
      "id": "alienus",
      "mid": "virga",
      "name": "Lynn Lesch",
      "pid": "sperno",
      "puuid": "a3bb402a-E9f3-44D2-7343-Bf98Ed2AfeEf",
      "read": true,
      "region": "cogo",
      "time": null,
      "type": "groupchat"
    }
  ]
}