# League of Legends webhooks

Signed POST requests to your URL when League of Legends events happen. Signing, retries, pauses and catch-up are the same for every sport: https://citoapi.com/docs/webhooks.md

Live catalog for this sport, with current status and volume: https://api.citoapi.com/api/v1/webhooks/events?game=lol
Human docs: https://citoapi.com/docs/api/league-of-legends/webhooks/
Status below was measured at 2026-11-08T20:30:57.835Z. Trust the live catalog over this file.

## Which events to subscribe to

- Live scoreboard: lol.live.game_started, lol.live.state, lol.score.updated, lol.match.completed. A live snapshot of gold, kills and objectives during each game, the series score between games, and the final result.
- Settle bets: lol.match.completed, lol.game.completed. Final series score and winner, plus each game. A corrected score sends a second lol.match.completed, so make settlement re-runnable.
- Results only: lol.match.completed. One event per final series score.
- Alerts: lol.match.started, lol.score.updated, lol.match.completed. Series start, each game result, and the final.

## Filters

- `league`: Only this league. On CS2 events the league is always cs2, so it does not narrow them.
- `matchId`: Only this match. Take the id from the schedule or live routes.
- `gameId`: Only one game inside a series.
- `side`: Only events for one side of the map.

## Events

### lol.match.started

A League of Legends series has started.

- When: When a series goes live. Once per match.
- Status: Active. Sent during the last 7 days.
- Frequency: about 5 per week
- Plan: Pro and Scale
- Filters: league, matchId
- Use it to: Flip a series to live in your app, or post a “series starting” alert.

| Field | Type | Meaning |
|---|---|---|
| `coverageLevel` | null or string | How much live detail this series has. |
| `format` | string | Series format, for example Bo5. |
| `league` | string | League name, or the sport id on CS2 events. |
| `leagueName` | string | Display name of the league. |
| `matchId` | string | The match id. Works on the match routes for this sport. |
| `payload_version` | number | Version of this payload shape. Newer events carry more fields. |
| `scheduledStart` | string | Scheduled start time, ISO 8601 UTC. |
| `startTime` | string | Start time, ISO 8601 UTC. |
| `streamLinks` | null or object | Stream links when known, otherwise null. |
| `teams` | array | The teams in this match. |
| `tournament` | string | Tournament id. |
| `tournamentName` | string | Display name of the tournament. |

```json
{
  "event": "lol.match.started",
  "id": "a1b2c3d4-0000-4000-8000-000000000000",
  "timestamp": "2026-11-04T22:10:06.862Z",
  "event_type": "lol.match.started",
  "match_id": "lol-match-115660540726095115",
  "previous_state": null,
  "data": {
    "teams": [
      "gen",
      "lyon-gaming"
    ],
    "format": "Bo5",
    "league": "Worlds",
    "matchId": "lol-match-115660540726095115",
    "startTime": "2026-11-04T22:00:00Z",
    "leagueName": "Worlds",
    "tournament": "lol-worlds_2026",
    "streamLinks": null,
    "coverageLevel": null,
    "scheduledStart": "2026-11-04T22:00:00Z",
    "tournamentName": "Worlds 2026",
    "payload_version": 2
  }
}
```

### lol.match.completed

A League of Legends series has finished, with the final score and winner.

- When: When a series ends. Once per final score, so a corrected score sends a second event.
- Status: Active. Sent during the last 7 days.
- Frequency: about 5 per week
- Plan: Pro and Scale
- Filters: league, matchId
- Use it to: Settle on the final score and winner. If data.statsPending is true, read /lol/matches/{matchId} again later for stats.
- Notes: data.statsPending true means per-game stats are still arriving. data.games and data.players appear on payload_version 2 events.

| Field | Type | Meaning |
|---|---|---|
| `format` | string | Series format, for example Bo5. |
| `games` | array | Per-game results of this series, on newer payloads. |
| `league` | string | League name, or the sport id on CS2 events. |
| `matchId` | string | The match id. Works on the match routes for this sport. |
| `payload_version` | number | Version of this payload shape. Newer events carry more fields. |
| `players` | array | Per-player stats, on newer payloads. |
| `score` | string | Series score, team1-team2 in the order of data.teams. |
| `statsPending` | boolean | True when per-game stats are still arriving. Read the match route again later. |
| `teams` | array | The teams in this match. |
| `tournament` | string | Tournament id. |
| `winner` | string | Winning team. |

```json
{
  "event": "lol.match.completed",
  "id": "a1b2c3d4-0000-4000-8000-000000000000",
  "timestamp": "2026-10-12T10:26:35.708Z",
  "event_type": "lol.match.completed",
  "match_id": "lol-match-117133830110912099",
  "previous_state": null,
  "data": {
    "games": [
      {
        "gameId": "lol-game-117133830110912100",
        "number": 1,
        "winner": null,
        "duration": 2098,
        "teamStats": {
          "red": {
            "gold": 61949,
            "kills": 8,
            "barons": 0,
            "towers": 5,
            "dragons": 3,
            "heralds": null,
            "inhibitors": 0
          },
          "blue": {
            "gold": 73829,
            "kills": 16,
            "barons": 2,
            "towers": 10,
            "dragons": 3,
            "heralds": null,
            "inhibitors": 2
          }
        }
      },
      {
        "gameId": "lol-game-117133830110912101",
        "number": 2,
        "winner": null,
        "duration": 2391,
        "teamStats": {
          "red": {
            "gold": 75687,
            "kills": 22,
            "barons": 2,
            "towers": 10,
            "dragons": 3,
            "heralds": null,
            "inhibitors": 2
          },
          "blue": {
            "gold": 73129,
            "kills": 16,
            "barons": 1,
            "towers": 8,
            "dragons": 3,
            "heralds": null,
            "inhibitors": 1
          }
        }
      },
      {
        "gameId": "lol-game-117133830110912102",
        "number": 3,
        "winner": null,
        "duration": 1393,
        "teamStats": {
          "red": {
            "gold": 35624,
            "kills": 2,
            "barons": 0,
            "towers": 0,
            "dragons": 0,
            "heralds": null,
            "inhibitors": 0
          },
          "blue": {
            "gold": 51569,
            "kills": 17,
            "barons": 1,
            "towers": 9,
            "dragons": 3,
            "heralds": null,
            "inhibitors": 1
          }
        }
      },
      {
        "gameId": "lol-game-117133830110912103",
        "number": 4,
        "winner": null,
        "duration": 1693,
        "teamStats": {
          "red": {
            "gold": 43752,
            "kills": 5,
            "barons": 0,
            "towers": 2,
            "dragons": 1,
            "heralds": null,
            "inhibitors": 0
          },
          "blue": {
            "gold": 54983,
            "kills": 15,
            "barons": 1,
            "towers": 10,
            "dragons": 2,
            "heralds": null,
            "inhibitors": 2
          }
        }
      },
      {
        "gameId": "lol-game-117133830110912104",
        "number": 5,
        "winner": "kt",
        "duration": null,
        "teamStats": {
          "red": {
            "gold": 60691,
            "kills": 20,
            "barons": 1,
            "towers": 2,
            "dragons": 4,
            "heralds": null,
            "inhibitors": 0
          },
          "blue": {
            "gold": 67041,
            "kills": 23,
            "barons": 0,
            "towers": 10,
            "dragons": 0,
            "heralds": null,
            "inhibitors": 2
          }
        }
      }
    ],
    "score": "3-2",
    "teams": [
      "kt",
      "team-vitality"
    ],
    "format": "Bo5",
    "league": "DCGI",
    "winner": "kt",
    "matchId": "lol-match-117133830110912099",
    "players": [
      {
        "id": "b5598781-6f93-4cd8-b516-3af0b34420b6",
        "name": "VITNaakNako",
        "team": "team-vitality",
        "avgCs": 227,
        "kills": 12,
        "deaths": 22,
        "assists": 21,
        "championPool": [
          "Rumble",
          "Ambessa",
          "Camille",
          "Cho'Gath",
          "Varus"
        ]
      },
      {
        "id": "50b1177b-c863-40fa-b3a8-0d6a13c9933e",
        "name": "KTPerfecT",
        "team": "kt",
        "avgCs": 247.4,
        "kills": 13,
        "deaths": 11,
        "assists": 29,
        "championPool": [
          "K'Sante",
          "Renekton",
          "Olaf",
          "Yorick",
          "Jax"
        ]
      },
      {
        "id": "032f9c34-51e8-4231-b50a-1ffd046d1db4",
        "name": "VITLyncas",
        "team": "team-vitality",
        "avgCs": 210.6,
        "kills": 16,
        "deaths": 13,
        "assists": 27,
        "championPool": [
          "Qiyana",
          "Lee Sin",
          "Wukong",
          "Trundle",
          "Aatrox"
        ]
      },
      {
        "id": "dea412e3-5797-4422-a999-86246dbd626d",
        "name": "VITFIESTA",
        "team": "team-vitality",
        "avgCs": 272.6,
        "kills": 18,
        "deaths": 17,
        "assists": 22,
        "championPool": [
          "Orianna",
          "Syndra",
          "Ahri",
          "Hwei",
          "Akali"
        ]
      },
      {
        "id": "be637a06-5fef-4c0c-a9db-f3cff4c4dcf1",
        "name": "VITFleshy",
        "team": "team-vitality",
        "avgCs": 36.2,
        "kills": 0,
        "deaths": 14,
        "assists": 52,
        "championPool": [
          "Rakan",
          "Alistar",
          "Nautilus",
          "Karma",
          "Blitzcrank"
        ]
      },
      {
        "id": "42674dd7-9981-4a42-973a-9152421f04a3",
        "name": "KTJiwoo",
        "team": "kt",
        "avgCs": 291.4,
        "kills": 32,
        "deaths": 14,
        "assists": 19,
        "championPool": [
          "Kalista",
          "Ezreal",
          "Miss Fortune",
          "Yunara",
          "Corki"
        ]
      },
      {
        "id": "c5ed5727-29f5-486f-82bd-697f1914f4e5",
        "name": "VITCarzzy",
        "team": "team-vitality",
        "avgCs": 293.4,
        "kills": 19,
        "deaths": 13,
        "assists": 27,
        "championPool": [
          "Xayah",
          "Ziggs",
          "Kai'Sa",
          "Caitlyn",
          "Aphelios"
        ]
      },
      {
        "id": "ecd7827d-b6bc-4281-b587-70ae5d0e4545",
        "name": "KTCuzz",
        "team": "kt",
        "avgCs": 198.4,
        "kills": 10,
        "deaths": 14,
        "assists": 50,
        "championPool": [
          "Pantheon",
          "Jarvan IV",
          "Vi",
          "Skarner",
          "Xin Zhao"
        ]
      },
      {
        "id": "27796c82-2b9c-4291-a967-fc94245ae4d6",
        "name": "KTBdd",
        "team": "kt",
        "avgCs": 281.8,
        "kills": 22,
        "deaths": 11,
        "assists": 34,
        "championPool": [
          "Ryze",
          "Viktor",
          "Taliyah",
          "Locke",
          "Vex"
        ]
      },
      {
        "id": "830c7c55-fc4d-488d-92f6-599a09833ae6",
        "name": "KTEffort",
        "team": "kt",
        "avgCs": 30.8,
        "kills": 2,
        "deaths": 15,
        "assists": 54,
        "championPool": [
          "Renata Glasc",
          "Seraphine",
          "Leona",
          "Lulu",
          "Maokai"
        ]
      }
    ],
    "tournament": "lol-tournament-117133773242499009",
    "statsPending": true,
    "payload_version": 2
  }
}
```

### lol.score.updated

A game inside a series ended and the series score changed.

- When: After each game of a series, once per result.
- Status: Active. Sent during the last 7 days.
- Frequency: about 132 per day across all matches (about 59 per match)
- Plan: Pro and Scale
- Filters: league, matchId
- Use it to: Update the series score after each game, and alert on the game winner.
- Notes: data.score is team1-team2 in the order of data.teams. data.gameWinner, data.gameId and data.gameNumber appear on most events, not all.

| Field | Type | Meaning |
|---|---|---|
| `gameId` | string | One game inside a series. |
| `gameNumber` | number | Which game of the series, from 1. |
| `gameWinner` | null or string | Team that won this game. |
| `league` | string | League name, or the sport id on CS2 events. |
| `matchId` | string | The match id. Works on the match routes for this sport. |
| `payload_version` | number | Version of this payload shape. Newer events carry more fields. |
| `previousScore` | string | Series score before this game. |
| `score` | string | Series score, team1-team2 in the order of data.teams. |
| `teams` | array | The teams in this match. |

```json
{
  "event": "lol.score.updated",
  "id": "a1b2c3d4-0000-4000-8000-000000000000",
  "timestamp": "2026-11-03T14:09:13.170Z",
  "event_type": "lol.score.updated",
  "match_id": "lol-match-116249880467010563",
  "previous_state": null,
  "data": {
    "score": "1-2",
    "teams": [
      "t1-challengers",
      "kt-challengers"
    ],
    "gameId": "lol-game-116249880467010566",
    "league": "LCK Challengers",
    "matchId": "lol-match-116249880467010563",
    "gameNumber": 3,
    "gameWinner": "kt-challengers",
    "previousScore": "2-1",
    "payload_version": 2
  }
}
```

### lol.standings.updated

League standings changed.

- When: When standings for a league change.
- Status: None recorded yet. You can subscribe, but none has been recorded. Do not rely on it.
- Frequency: none recorded so far
- Plan: Pro and Scale
- Filters: none
- Use it to: Re-read the league table instead of polling it.

### lol.transfer.new

A player transfer was recorded.

- When: When a new transfer is recorded.
- Status: Active. Sent during the last 7 days.
- Frequency: about 5 per week
- Plan: Pro and Scale
- Filters: none
- Use it to: Refresh a roster page or post a roster-move alert.

### lol.tournament.started

A tournament has started.

- When: When a tournament begins.
- Status: None recorded yet. You can subscribe, but none has been recorded. Do not rely on it.
- Frequency: none recorded so far
- Plan: Pro and Scale
- Filters: none
- Use it to: Open a tournament hub or switch your schedule view.

### lol.tournament.completed

A tournament has finished.

- When: When a tournament ends.
- Status: None recorded yet. You can subscribe, but none has been recorded. Do not rely on it.
- Frequency: none recorded so far
- Plan: Pro and Scale
- Filters: none
- Use it to: Close out a tournament page and fetch final standings.

### lol.live.game_started

A game inside a live series has started.

- When: When a game of a tracked series goes in progress.
- Status: Active. Sent during the last 7 days.
- Frequency: about 5 per day across all matches (about 4 per match)
- Plan: Pro and Scale
- Filters: matchId
- Use it to: Open the live view for that game and start reading live state.
- Notes: Some events carry matchId only. data.teams.red and data.teams.blue are team ids. matchId, gameId and canonicalGameId identify the series and the game; pass canonicalGameId or gameId to /lol/games/{gameId}.

| Field | Type | Meaning |
|---|---|---|
| `canonicalGameId` | string | The game id to pass to /lol/games/{gameId}. |
| `gameId` | string | One game inside a series. |
| `gameNumber` | number | Which game of the series, from 1. |
| `gameState` | string | State of the game, for example in_game. |
| `gameTime` | null | Game clock in minutes on change events, seconds on state snapshots. |
| `league` | string | League name, or the sport id on CS2 events. |
| `leagueId` | string | League id. |
| `leagueSlug` | string | League slug. |
| `matchId` | string | The match id. Works on the match routes for this sport. |
| `sampledAt` | string | When this snapshot of the game was taken. |
| `sequenceNumber` | number | Order of snapshots within one game. Higher is newer. |
| `teams` | object | The teams in this match. |

```json
{
  "event": "lol.live.game_started",
  "id": "a1b2c3d4-0000-4000-8000-000000000000",
  "timestamp": "2026-10-31T17:57:25.477Z",
  "event_type": "lol.live.game_started",
  "match_id": "lol-match-115660540726095085",
  "previous_state": null,
  "data": {
    "teams": {
      "red": "103461966965149786",
      "blue": "111692118851466302"
    },
    "gameId": "115660540726095087",
    "league": "Worlds",
    "matchId": "lol-match-115660540726095085",
    "gameTime": null,
    "leagueId": "98767975604431411",
    "gameState": "inProgress",
    "sampledAt": "2026-10-31T17:57:25.403Z",
    "gameNumber": 2,
    "leagueSlug": "worlds",
    "canonicalGameId": "lol-game-115660540726095087"
  }
}
```

### lol.live.state

A snapshot of a live game: gold, kills, towers, barons, dragons and inhibitors for both sides.

- When: Repeatedly during a live game, on tracked leagues.
- Status: Active. Sent during the last 7 days.
- Frequency: about 127 per day across all matches (about 177 per match)
- Plan: Pro and Scale
- Filters: league, matchId, gameId
- Use it to: Drive a live scoreboard: gold, kills, towers, dragons and barons for both sides.
- Notes: data.teams.red and data.teams.blue are team ids. matchId, gameId and canonicalGameId identify the series and the game; pass canonicalGameId or gameId to /lol/games/{gameId}. Check GET /lol/matches/{matchId}/coverage for expected_webhooks before relying on it.

| Field | Type | Meaning |
|---|---|---|
| `blue` | object | Totals for the blue side. |
| `canonicalGameId` | string | The game id to pass to /lol/games/{gameId}. |
| `gameId` | string | One game inside a series. |
| `gameNumber` | number | Which game of the series, from 1. |
| `gameTime` | number | Game clock in minutes on change events, seconds on state snapshots. |
| `goldDiff` | number | Blue gold minus red gold. Negative means red leads. |
| `league` | string | League name, or the sport id on CS2 events. |
| `leagueId` | string | League id. |
| `leagueSlug` | string | League slug. |
| `matchId` | string | The match id. Works on the match routes for this sport. |
| `red` | object | Totals for the red side. |
| `sampledAt` | string | When this snapshot of the game was taken. |
| `teams` | object | The teams in this match. |

```json
{
  "event": "lol.live.state",
  "id": "a1b2c3d4-0000-4000-8000-000000000000",
  "timestamp": "2026-11-08T00:46:47.528Z",
  "event_type": "lol.live.state",
  "match_id": "lol-match-115660540726095127",
  "previous_state": null,
  "data": {
    "red": {
      "gold": 78179,
      "kills": 16,
      "barons": 1,
      "towers": 9,
      "dragons": [
        "mountain",
        "mountain"
      ],
      "inhibitors": 1
    },
    "blue": {
      "gold": 71690,
      "kills": 18,
      "barons": 0,
      "towers": 5,
      "dragons": [
        "ocean",
        "hextech",
        "mountain",
        "mountain"
      ],
      "inhibitors": 0
    },
    "teams": {
      "red": "100205573495116443",
      "blue": "99566404848691211"
    },
    "gameId": "115660540726095130",
    "league": "Worlds",
    "matchId": "lol-match-115660540726095127",
    "gameTime": 4,
    "goldDiff": -6489,
    "leagueId": "98767975604431411",
    "sampledAt": "2026-11-08T00:41:06.806Z",
    "gameNumber": 3,
    "leagueSlug": "worlds",
    "canonicalGameId": "lol-game-115660540726095130"
  }
}
```

### lol.live.objective

A side took an objective (data.objective, data.side), with running totals.

- When: When a baron, dragon or inhibitor falls in a live game.
- Status: Active. Sent during the last 7 days.
- Frequency: about 19 per day across all matches (about 27 per match)
- Plan: Pro and Scale
- Filters: league, matchId, gameId, side
- Use it to: Show a “Baron taken” style moment in a feed, or trigger an alert.
- Notes: data.teams.red and data.teams.blue are team ids. matchId, gameId and canonicalGameId identify the series and the game; pass canonicalGameId or gameId to /lol/games/{gameId}.

| Field | Type | Meaning |
|---|---|---|
| `canonicalGameId` | string | The game id to pass to /lol/games/{gameId}. |
| `gameId` | string | One game inside a series. |
| `gameNumber` | number | Which game of the series, from 1. |
| `gameTime` | number | Game clock in minutes on change events, seconds on state snapshots. |
| `league` | string | League name, or the sport id on CS2 events. |
| `leagueId` | string | League id. |
| `leagueSlug` | string | League slug. |
| `matchId` | string | The match id. Works on the match routes for this sport. |
| `objective` | string | The objective taken, for example baron. |
| `objectiveType` | string | The kind of objective. |
| `sampledAt` | string | When this snapshot of the game was taken. |
| `side` | string | red or blue. |
| `teams` | object | The teams in this match. |
| `totals` | object | Running totals per side. |

```json
{
  "event": "lol.live.objective",
  "id": "a1b2c3d4-0000-4000-8000-000000000000",
  "timestamp": "2026-11-08T00:40:13.786Z",
  "event_type": "lol.live.objective",
  "match_id": "lol-match-115660540726095127",
  "previous_state": null,
  "data": {
    "side": "blue",
    "teams": {
      "red": "100205573495116443",
      "blue": "99566404848691211"
    },
    "gameId": "115660540726095130",
    "league": "Worlds",
    "totals": {
      "redBarons": 1,
      "blueBarons": 0,
      "redDragons": 2,
      "blueDragons": 4,
      "redInhibitors": 0,
      "blueInhibitors": 0
    },
    "matchId": "lol-match-115660540726095127",
    "gameTime": 9,
    "leagueId": "98767975604431411",
    "objective": "dragon",
    "sampledAt": "2026-11-08T00:36:59.780Z",
    "gameNumber": 3,
    "leagueSlug": "worlds",
    "objectiveType": "mountain",
    "canonicalGameId": "lol-game-115660540726095130"
  }
}
```

### lol.live.gold_swing

The gold lead moved sharply.

- When: When the gold difference moves by a large amount between two samples of a live game.
- Status: Active. Sent during the last 7 days.
- Frequency: about 22 per day across all matches (about 31 per match)
- Plan: Pro and Scale
- Filters: league, matchId, gameId
- Use it to: Flag momentum shifts for live commentary or in-play models.
- Notes: data.swing is the change in data.goldDiff. data.teams.red and data.teams.blue are team ids. matchId, gameId and canonicalGameId identify the series and the game; pass canonicalGameId or gameId to /lol/games/{gameId}.

| Field | Type | Meaning |
|---|---|---|
| `blueGold` | number | Blue side gold. |
| `canonicalGameId` | string | The game id to pass to /lol/games/{gameId}. |
| `gameId` | string | One game inside a series. |
| `gameNumber` | number | Which game of the series, from 1. |
| `gameTime` | number | Game clock in minutes on change events, seconds on state snapshots. |
| `goldDiff` | number | Blue gold minus red gold. Negative means red leads. |
| `leadingSide` | string | The side ahead on gold. |
| `league` | string | League name, or the sport id on CS2 events. |
| `leagueId` | string | League id. |
| `leagueSlug` | string | League slug. |
| `matchId` | string | The match id. Works on the match routes for this sport. |
| `previousGoldDiff` | number | goldDiff before this change. |
| `redGold` | number | Red side gold. |
| `sampledAt` | string | When this snapshot of the game was taken. |
| `swing` | number | The change in goldDiff. |
| `teams` | object | The teams in this match. |

```json
{
  "event": "lol.live.gold_swing",
  "id": "a1b2c3d4-0000-4000-8000-000000000000",
  "timestamp": "2026-11-08T00:44:16.137Z",
  "event_type": "lol.live.gold_swing",
  "match_id": "lol-match-115660540726095127",
  "previous_state": null,
  "data": {
    "swing": -1166,
    "teams": {
      "red": "100205573495116443",
      "blue": "99566404848691211"
    },
    "gameId": "115660540726095130",
    "league": "Worlds",
    "matchId": "lol-match-115660540726095127",
    "redGold": 77295,
    "blueGold": 71601,
    "gameTime": 9,
    "goldDiff": -5694,
    "leagueId": "98767975604431411",
    "sampledAt": "2026-11-08T00:40:59.782Z",
    "gameNumber": 3,
    "leagueSlug": "worlds",
    "leadingSide": "red",
    "canonicalGameId": "lol-game-115660540726095130",
    "previousGoldDiff": -4528
  }
}
```

### lol.live.kill_update

Team kill totals changed.

- When: When kills change between two samples of a live game.
- Status: Active. Sent during the last 7 days.
- Frequency: about 41 per day across all matches (about 57 per match)
- Plan: Pro and Scale
- Filters: league, matchId, gameId
- Use it to: Tick kill counters without waiting for the next state snapshot.
- Notes: data.delta holds the kills added per side. data.teams.red and data.teams.blue are team ids. matchId, gameId and canonicalGameId identify the series and the game; pass canonicalGameId or gameId to /lol/games/{gameId}.

| Field | Type | Meaning |
|---|---|---|
| `blueKills` | number | Blue side kills. |
| `canonicalGameId` | string | The game id to pass to /lol/games/{gameId}. |
| `delta` | object | What was added per side since the last sample. |
| `gameId` | string | One game inside a series. |
| `gameNumber` | number | Which game of the series, from 1. |
| `gameTime` | number | Game clock in minutes on change events, seconds on state snapshots. |
| `league` | string | League name, or the sport id on CS2 events. |
| `leagueId` | string | League id. |
| `leagueSlug` | string | League slug. |
| `matchId` | string | The match id. Works on the match routes for this sport. |
| `redKills` | number | Red side kills. |
| `sampledAt` | string | When this snapshot of the game was taken. |
| `teams` | object | The teams in this match. |

```json
{
  "event": "lol.live.kill_update",
  "id": "a1b2c3d4-0000-4000-8000-000000000000",
  "timestamp": "2026-11-08T00:44:26.967Z",
  "event_type": "lol.live.kill_update",
  "match_id": "lol-match-115660540726095127",
  "previous_state": null,
  "data": {
    "delta": {
      "red": 1,
      "blue": 0
    },
    "teams": {
      "red": "100205573495116443",
      "blue": "99566404848691211"
    },
    "gameId": "115660540726095130",
    "league": "Worlds",
    "matchId": "lol-match-115660540726095127",
    "gameTime": 6,
    "leagueId": "98767975604431411",
    "redKills": 16,
    "blueKills": 18,
    "sampledAt": "2026-11-08T00:41:06.806Z",
    "gameNumber": 3,
    "leagueSlug": "worlds",
    "canonicalGameId": "lol-game-115660540726095130"
  }
}
```

### lol.live.tower_destroyed

A tower fell.

- When: When tower totals change between two samples of a live game.
- Status: Active. Sent during the last 7 days.
- Frequency: about 31 per day across all matches (about 43 per match)
- Plan: Pro and Scale
- Filters: league, matchId, gameId
- Use it to: Tick tower counts and show map pressure.
- Notes: data.delta holds the towers added per side. data.teams.red and data.teams.blue are team ids. matchId, gameId and canonicalGameId identify the series and the game; pass canonicalGameId or gameId to /lol/games/{gameId}.

| Field | Type | Meaning |
|---|---|---|
| `blueTowers` | number | Blue side towers. |
| `canonicalGameId` | string | The game id to pass to /lol/games/{gameId}. |
| `delta` | object | What was added per side since the last sample. |
| `gameId` | string | One game inside a series. |
| `gameNumber` | number | Which game of the series, from 1. |
| `gameTime` | number | Game clock in minutes on change events, seconds on state snapshots. |
| `league` | string | League name, or the sport id on CS2 events. |
| `leagueId` | string | League id. |
| `leagueSlug` | string | League slug. |
| `matchId` | string | The match id. Works on the match routes for this sport. |
| `redTowers` | number | Red side towers. |
| `sampledAt` | string | When this snapshot of the game was taken. |
| `teams` | object | The teams in this match. |

```json
{
  "event": "lol.live.tower_destroyed",
  "id": "a1b2c3d4-0000-4000-8000-000000000000",
  "timestamp": "2026-11-07T00:21:50.600Z",
  "event_type": "lol.live.tower_destroyed",
  "match_id": "lol-match-115660540726095103",
  "previous_state": null,
  "data": {
    "delta": {
      "red": 0,
      "blue": 4
    },
    "teams": {
      "red": "98767991853197861",
      "blue": "111692118851466302"
    },
    "gameId": "115660540726095106",
    "league": "Worlds",
    "matchId": "lol-match-115660540726095103",
    "gameTime": 0,
    "leagueId": "98767975604431411",
    "redTowers": 11,
    "sampledAt": "2026-11-07T00:21:50.176Z",
    "blueTowers": 11,
    "gameNumber": 3,
    "leagueSlug": "worlds",
    "canonicalGameId": "lol-game-115660540726095106"
  }
}
```

### lol.live.player_down

One or more players died, with champion, role and death count.

- When: When a player death is seen in a live game.
- Status: Quiet. You can subscribe, but it has not been sent recently. Do not build on it alone without checking lastSentAt.
- Frequency: none in the last 7 days; last sent 2026-08-21
- Plan: Pro and Scale
- Filters: league, matchId, gameId
- Use it to: Show who is dead on a live board.
- Notes: data.teams.red and data.teams.blue are team ids. matchId, gameId and canonicalGameId identify the series and the game; pass canonicalGameId or gameId to /lol/games/{gameId}.

| Field | Type | Meaning |
|---|---|---|
| `canonicalGameId` | string | The game id to pass to /lol/games/{gameId}. |
| `gameId` | string | One game inside a series. |
| `gameNumber` | number | Which game of the series, from 1. |
| `gameTime` | null or number | Game clock in minutes on change events, seconds on state snapshots. |
| `league` | string | League name, or the sport id on CS2 events. |
| `leagueId` | string | League id. |
| `leagueSlug` | string | League slug. |
| `matchId` | string | The match id. Works on the match routes for this sport. |
| `playersDown` | array | Players currently dead, with champion, role and death count. |
| `sampledAt` | string | When this snapshot of the game was taken. |
| `teams` | object | The teams in this match. |

```json
{
  "event": "lol.live.player_down",
  "id": "a1b2c3d4-0000-4000-8000-000000000000",
  "timestamp": "2026-08-21T00:42:41.281Z",
  "event_type": "lol.live.player_down",
  "match_id": "lol-match-116792888905448318",
  "previous_state": null,
  "data": {
    "teams": {
      "red": "102141671183409133",
      "blue": "114746424759893687"
    },
    "gameId": "116792888905448320",
    "league": "NACL",
    "matchId": "lol-match-116792888905448318",
    "gameTime": 771,
    "leagueId": "109511549831443335",
    "sampledAt": "2026-08-21T00:36:59.878Z",
    "gameNumber": 2,
    "leagueSlug": "nacl",
    "playersDown": [
      {
        "role": "top",
        "side": "blue",
        "deaths": 1,
        "championId": "Olaf",
        "summonerName": "DOG Dcoy",
        "participantId": 1
      },
      {
        "role": "jungle",
        "side": "blue",
        "deaths": 2,
        "championId": "Maokai",
        "summonerName": "DOG Lojaz",
        "participantId": 2
      },
      {
        "role": "top",
        "side": "red",
        "deaths": 1,
        "championId": "Ambessa",
        "summonerName": "MU Crimson",
        "participantId": 6
      },
      {
        "role": "bottom",
        "side": "red",
        "deaths": 1,
        "championId": "Jhin",
        "summonerName": "MU Scary Jerry",
        "participantId": 9
      },
      {
        "role": "support",
        "side": "red",
        "deaths": 1,
        "championId": "Nautilus",
        "summonerName": "MU Obstinatus",
        "participantId": 10
      }
    ],
    "canonicalGameId": "lol-game-116792888905448320"
  }
}
```

### lol.live.map_delta

Per-player alive state and map position changed.

- When: During a live game.
- Status: Quiet. You can subscribe, but it has not been sent recently. Do not build on it alone without checking lastSentAt.
- Frequency: none in the last 7 days; last sent 2026-08-21
- Plan: Pro and Scale
- Filters: league, matchId, gameId
- Use it to: Update a live map or alive-state overlay.
- Notes: data.teams.red and data.teams.blue are team ids. matchId, gameId and canonicalGameId identify the series and the game; pass canonicalGameId or gameId to /lol/games/{gameId}.

| Field | Type | Meaning |
|---|---|---|
| `canonicalGameId` | string | The game id to pass to /lol/games/{gameId}. |
| `gameId` | string | One game inside a series. |
| `gameNumber` | number | Which game of the series, from 1. |
| `gameTime` | null or number | Game clock in minutes on change events, seconds on state snapshots. |
| `league` | string | League name, or the sport id on CS2 events. |
| `leagueId` | string | League id. |
| `leagueSlug` | string | League slug. |
| `matchId` | string | The match id. Works on the match routes for this sport. |
| `players` | array | Per-player stats, on newer payloads. |
| `sampledAt` | string | When this snapshot of the game was taken. |
| `teams` | object | The teams in this match. |

```json
{
  "event": "lol.live.map_delta",
  "id": "a1b2c3d4-0000-4000-8000-000000000000",
  "timestamp": "2026-08-21T00:47:11.907Z",
  "event_type": "lol.live.map_delta",
  "match_id": "lol-match-116792888905448318",
  "previous_state": null,
  "data": {
    "teams": {
      "red": "102141671183409133",
      "blue": "114746424759893687"
    },
    "gameId": "116792888905448320",
    "league": "NACL",
    "matchId": "lol-match-116792888905448318",
    "players": [
      {
        "side": "blue",
        "alive": true,
        "position": null,
        "participantId": 1
      },
      {
        "side": "blue",
        "alive": false,
        "position": null,
        "participantId": 2
      },
      {
        "side": "blue",
        "alive": false,
        "position": null,
        "participantId": 3
      },
      {
        "side": "blue",
        "alive": true,
        "position": null,
        "participantId": 4
      },
      {
        "side": "blue",
        "alive": true,
        "position": null,
        "participantId": 5
      },
      {
        "side": "red",
        "alive": false,
        "position": null,
        "participantId": 6
      },
      {
        "side": "red",
        "alive": false,
        "position": null,
        "participantId": 7
      },
      {
        "side": "red",
        "alive": true,
        "position": null,
        "participantId": 8
      },
      {
        "side": "red",
        "alive": true,
        "position": null,
        "participantId": 9
      },
      {
        "side": "red",
        "alive": true,
        "position": null,
        "participantId": 10
      }
    ],
    "gameTime": 1050,
    "leagueId": "109511549831443335",
    "sampledAt": "2026-08-21T00:41:39.224Z",
    "gameNumber": 2,
    "leagueSlug": "nacl",
    "canonicalGameId": "lol-game-116792888905448320"
  }
}
```

### lol.live.pick_locked

A champion pick was locked in.

- When: During the draft of a live game.
- Status: Quiet. You can subscribe, but it has not been sent recently. Do not build on it alone without checking lastSentAt.
- Frequency: none in the last 7 days; last sent 2026-08-21
- Plan: Pro and Scale
- Filters: league, matchId, gameId, side
- Use it to: Show the draft as it locks, one champion at a time.
- Notes: data.teams.red and data.teams.blue are team ids. matchId, gameId and canonicalGameId identify the series and the game; pass canonicalGameId or gameId to /lol/games/{gameId}.

| Field | Type | Meaning |
|---|---|---|
| `bans` | array | Bans so far. |
| `canonicalGameId` | string | The game id to pass to /lol/games/{gameId}. |
| `championId` | string | Champion id. |
| `gameId` | string | One game inside a series. |
| `gameNumber` | number | Which game of the series, from 1. |
| `gameState` | string | State of the game, for example in_game. |
| `gameTime` | null | Game clock in minutes on change events, seconds on state snapshots. |
| `league` | string | League name, or the sport id on CS2 events. |
| `leagueId` | string | League id. |
| `leagueSlug` | string | League slug. |
| `matchId` | string | The match id. Works on the match routes for this sport. |
| `participantId` | number | Player slot in the game. |
| `patchVersion` | string | Game patch. |
| `picks` | array | Picks so far. |
| `role` | string | Player role. |
| `sampledAt` | string | When this snapshot of the game was taken. |
| `side` | string | red or blue. |
| `summonerName` | string | Player name in game. |
| `teams` | object | The teams in this match. |

```json
{
  "event": "lol.live.pick_locked",
  "id": "a1b2c3d4-0000-4000-8000-000000000000",
  "timestamp": "2026-08-20T22:55:23.881Z",
  "event_type": "lol.live.pick_locked",
  "match_id": "lol-match-116792888905448314",
  "previous_state": null,
  "data": {
    "bans": [],
    "role": "mid",
    "side": "blue",
    "picks": [
      {
        "role": "top",
        "side": "blue",
        "championId": "Ambessa",
        "summonerName": "CPD Horder",
        "participantId": 1
      },
      {
        "role": "jungle",
        "side": "blue",
        "championId": "Qiyana",
        "summonerName": "CPD Music",
        "participantId": 2
      },
      {
        "role": "mid",
        "side": "blue",
        "championId": "Cassiopeia",
        "summonerName": "CPD Ablazeolive",
        "participantId": 3
      },
      {
        "role": "bottom",
        "side": "blue",
        "championId": "Kaisa",
        "summonerName": "CPD Mobility",
        "participantId": 4
      },
      {
        "role": "support",
        "side": "blue",
        "championId": "Rell",
        "summonerName": "CPD Breezy",
        "participantId": 5
      },
      {
        "role": "top",
        "side": "red",
        "championId": "Riven",
        "summonerName": "CNV Sniper",
        "participantId": 6
      },
      {
        "role": "jungle",
        "side": "red",
        "championId": "JarvanIV",
        "summonerName": "CNV Tomio",
        "participantId": 7
      },
      {
        "role": "mid",
        "side": "red",
        "championId": "Syndra",
        "summonerName": "CNV Insanity",
        "participantId": 8
      },
      {
        "role": "bottom",
        "side": "red",
        "championId": "Ezreal",
        "summonerName": "CNV Cody Sun",
        "participantId": 9
      },
      {
        "role": "support",
        "side": "red",
        "championId": "Shen",
        "summonerName": "CNV Zyko",
        "participantId": 10
      }
    ],
    "teams": {
      "red": "109783170393931575",
      "blue": "116877540282721669"
    },
    "gameId": "116792888905448316",
    "league": "NACL",
    "matchId": "lol-match-116792888905448314",
    "gameTime": null,
    "leagueId": "109511549831443335",
    "gameState": "in_game",
    "sampledAt": "2026-08-20T22:49:49.980Z",
    "championId": "Cassiopeia",
    "gameNumber": 2,
    "leagueSlug": "nacl",
    "patchVersion": "16.16.805.442",
    "summonerName": "CPD Ablazeolive",
    "participantId": 3,
    "canonicalGameId": "lol-game-116792888905448316"
  }
}
```

### lol.game.completed

One game of a series finished, with draft, team stats, players and first objectives.

- When: When a game inside a series ends.
- Status: Active. Sent during the last 7 days.
- Frequency: about 3 per week
- Plan: Pro and Scale
- Filters: matchId, gameId
- Use it to: Store the game: draft, team stats, players and first objectives. If data.statsPending is true, read /lol/games/{gameId} a little later.
- Notes: data.statsPending true means the stats are still arriving. Read /lol/games/{gameId} a little later for the complete record.

| Field | Type | Meaning |
|---|---|---|
| `draft` | object | Picks and bans of this game. |
| `duration` | null or number | Game length. |
| `firstObjectives` | object | Which team took each first objective. |
| `gameId` | string | One game inside a series. |
| `gameNumber` | number | Which game of the series, from 1. |
| `matchId` | string | The match id. Works on the match routes for this sport. |
| `patch` | null or string | Game patch. |
| `payload_version` | number | Version of this payload shape. Newer events carry more fields. |
| `players` | object | Per-player stats, on newer payloads. |
| `statsPending` | boolean | True when per-game stats are still arriving. Read the match route again later. |
| `teams` | object | The teams in this match. |
| `teamStats` | object | Team totals for the game. |
| `winner` | null or string | Winning team. |

```json
{
  "event": "lol.game.completed",
  "id": "a1b2c3d4-0000-4000-8000-000000000000",
  "timestamp": "2026-08-21T00:56:19.279Z",
  "event_type": "lol.game.completed",
  "match_id": "lol-match-116792888905448318",
  "previous_state": null,
  "data": {
    "draft": {
      "picks": {
        "red": [
          "Jhin",
          "Ambessa",
          "Nautilus",
          "Lee Sin",
          "Cassiopeia"
        ],
        "blue": [
          "Zeri",
          "Corki",
          "Alistar",
          "Olaf",
          "Maokai"
        ]
      },
      "redBans": [],
      "blueBans": []
    },
    "patch": "16.16.805.442",
    "teams": {
      "red": {
        "code": "MU",
        "name": "Maryville University",
        "slug": "maryville-university"
      },
      "blue": {
        "code": "DOG",
        "name": "Dorado Gaming",
        "slug": "dog"
      }
    },
    "gameId": "lol-game-116792888905448320",
    "winner": "maryville-university",
    "matchId": "lol-match-116792888905448318",
    "players": {
      "red": [
        {
          "cs": 229,
          "id": "1d18b5d5-7c5a-4593-a1c9-9192f8948560",
          "gold": 12473,
          "name": "Scary Jerry",
          "kills": 3,
          "deaths": 2,
          "assists": 17,
          "champion": "Jhin",
          "position": "ADC"
        },
        {
          "cs": 211,
          "id": "4ef78162-ec11-4ab6-b8bd-8ab3d338f043",
          "gold": 10283,
          "name": "Crimson",
          "kills": 5,
          "deaths": 2,
          "assists": 9,
          "champion": "Ambessa",
          "position": "Top"
        },
        {
          "cs": 23,
          "id": "08b82514-9517-43ee-b72b-0cd93ff5f056",
          "gold": 7322,
          "name": "Obstinatus",
          "kills": 0,
          "deaths": 1,
          "assists": 21,
          "champion": "Nautilus",
          "position": "Support"
        },
        {
          "cs": 171,
          "id": "8f9b0edd-f49d-4333-a9e8-41399c94468c",
          "gold": 11079,
          "name": "Niles",
          "kills": 5,
          "deaths": 2,
          "assists": 16,
          "champion": "Lee Sin",
          "position": "Jungle"
        },
        {
          "cs": 248,
          "id": "18a0192f-b383-45b8-bbb7-109b232ed0ac",
          "gold": 13393,
          "name": "AoJune",
          "kills": 14,
          "deaths": 0,
          "assists": 6,
          "champion": "Cassiopeia",
          "position": "Mid"
        }
      ],
      "blue": [
        {
          "cs": 234,
          "id": "6d2f4263-798e-447d-85c6-89f1786f1e22",
          "gold": 10872,
          "name": "aadam",
          "kills": 4,
          "deaths": 6,
          "assists": 3,
          "champion": "Zeri",
          "position": "Mid"
        },
        {
          "cs": 209,
          "id": "d84b2c65-9c33-422b-9ab7-daaaa8956795",
          "gold": 9227,
          "name": "Hub",
          "kills": 0,
          "deaths": 3,
          "assists": 5,
          "champion": "Corki",
          "position": "ADC"
        },
        {
          "cs": 27,
          "id": "0c6ed2c1-0804-4d89-a334-cf4e13fce5e6",
          "gold": 5911,
          "name": "InFlame",
          "kills": 0,
          "deaths": 8,
          "assists": 4,
          "champion": "Alistar",
          "position": "Support"
        },
        {
          "cs": 208,
          "id": "9cdfb559-174a-4d30-93db-2d9438452018",
          "gold": 8260,
          "name": "Dcoy",
          "kills": 1,
          "deaths": 3,
          "assists": 1,
          "champion": "Olaf",
          "position": "Top"
        },
        {
          "cs": 162,
          "id": "3de113b1-2e66-453c-a8c6-445667ba1504",
          "gold": 9140,
          "name": "Lojaz",
          "kills": 2,
          "deaths": 7,
          "assists": 4,
          "champion": "Maokai",
          "position": "Jungle"
        }
      ]
    },
    "duration": 1569,
    "teamStats": {
      "red": {
        "gold": 58388,
        "kills": 31,
        "barons": 1,
        "towers": 8,
        "dragons": 4,
        "heralds": null,
        "inhibitors": 1
      },
      "blue": {
        "gold": 45032,
        "kills": 8,
        "barons": 0,
        "towers": 1,
        "dragons": 0,
        "heralds": null,
        "inhibitors": 0
      }
    },
    "gameNumber": 2,
    "firstObjectives": {
      "firstBaron": "red",
      "firstBlood": "red",
      "firstTower": "red",
      "firstDragon": "red",
      "firstHerald": null
    },
    "payload_version": 2
  }
}
```

### lol.draft.updated

A pick or ban was made in a live draft.

- When: During the draft of a live game.
- Status: Quiet. You can subscribe, but it has not been sent recently. Do not build on it alone without checking lastSentAt.
- Frequency: none in the last 7 days; last sent 2026-08-21
- Plan: Pro and Scale
- Filters: league, matchId, gameId
- Use it to: Replace your stored draft state with the latest picks and bans.
- Notes: data.teams.red and data.teams.blue are team ids. matchId, gameId and canonicalGameId identify the series and the game; pass canonicalGameId or gameId to /lol/games/{gameId}.

| Field | Type | Meaning |
|---|---|---|
| `action` | string | pick or ban. |
| `bansSoFar` | number | Bans made up to this action. |
| `canonicalGameId` | string | The game id to pass to /lol/games/{gameId}. |
| `champion` | string | Champion picked or banned. |
| `gameId` | string | One game inside a series. |
| `gameNumber` | number | Which game of the series, from 1. |
| `gameTime` | null | Game clock in minutes on change events, seconds on state snapshots. |
| `league` | string | League name, or the sport id on CS2 events. |
| `leagueId` | string | League id. |
| `leagueSlug` | string | League slug. |
| `matchId` | string | The match id. Works on the match routes for this sport. |
| `order` | number | Position in the draft order. |
| `payload_version` | number | Version of this payload shape. Newer events carry more fields. |
| `picksSoFar` | number | Picks made up to this action. |
| `sampledAt` | string | When this snapshot of the game was taken. |
| `team` | string | Team making this action. |
| `teams` | object | The teams in this match. |

```json
{
  "event": "lol.draft.updated",
  "id": "a1b2c3d4-0000-4000-8000-000000000000",
  "timestamp": "2026-08-20T22:55:23.885Z",
  "event_type": "lol.draft.updated",
  "match_id": "lol-match-116792888905448314",
  "previous_state": null,
  "data": {
    "team": "blue",
    "order": 3,
    "teams": {
      "red": "109783170393931575",
      "blue": "116877540282721669"
    },
    "action": "pick",
    "gameId": "116792888905448316",
    "league": "NACL",
    "matchId": "lol-match-116792888905448314",
    "champion": "Cassiopeia",
    "gameTime": null,
    "leagueId": "109511549831443335",
    "bansSoFar": 0,
    "sampledAt": "2026-08-20T22:49:49.980Z",
    "gameNumber": 2,
    "leagueSlug": "nacl",
    "picksSoFar": 10,
    "canonicalGameId": "lol-game-116792888905448316",
    "payload_version": 2
  }
}
```