---
title: "Stream games by IDs"
method: POST
path: "/api/stream/games/{streamId}"
tags: ["Games"]
---

# Stream games by IDs

`POST /api/stream/games/{streamId}`

Creates a stream of games from an arbitrary streamId, and a list of game IDs.
The stream first outputs the games that already exists, then emits an event each time a game is started or finished.
Games are streamed as [ndjson](#description/streaming-with-nd-json).
Maximum number of games: 500 for anonymous requests, or 1000 for [OAuth2 authenticated](#description/authentication) requests.
While the stream is open, it is possible to [add new game IDs to watch](#tag/games/POST/api/stream/games/{streamId}/add).

## Path parameters

- `streamId` string, required — Arbitrary stream ID that you can later use to add game IDs to the stream.

## Response `200`

The stream of the games matching the requested IDs.

---

[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)