---
title: "Stream Board game state"
method: GET
path: "/api/board/game/stream/{gameId}"
tags: ["Board"]
---

# Stream Board game state

`GET /api/board/game/stream/{gameId}`

Stream the state of a game being played with the Board API, as [ndjson](#description/streaming-with-nd-json).

Use this endpoint to get updates about the game in real-time, with a single request.

Each line is a JSON object containing a `type` field. Possible values are:
  - `gameFull` Full game data. All values are immutable, except for the `state` field.
  - `gameState` Current state of the game. Immutable values not included. Sent when a move is played, a draw is offered, or when the game ends.
  - `chatLine` Chat message sent by a user in the `room` "player" or "spectator".
  - `opponentGone` Whether the opponent has left the game, and how long before you can claim a win or draw.

The first line is always of type `gameFull`.

The server closes the stream when the game ends, or if the game has already ended.

## Path parameters

- `gameId` string, required

## Response `200`

The stream of the game.

## Other responses

- `404` — The game was not found.

---

[API](https://skmtc.net/lichess/apis/lichess-org-api-reference.md) · [All operations](https://skmtc.net/lichess/apis/lichess-org-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lichess/lichess-org-api-reference/versions/1425db81eb3b/schema)