---
title: "Stream games of users"
method: POST
path: "/api/stream/games-by-users"
tags: ["Games"]
---

# Stream games of users

`POST /api/stream/games-by-users`

Stream the games played between a list of users, in real time.
Only games where **both players** are part of the list are included.
The stream emits an event each time a game is started or finished.
To also get all current ongoing games at the beginning of the stream, use the `withCurrentGames` flag.
Games are streamed as [ndjson](#description/streaming-with-nd-json).
Maximum number of users: 300.
The method is `POST` so a longer list of IDs can be sent in the request body.

## Query parameters

- `withCurrentGames` boolean

## Response `200`

The stream of the games played between the users.

---

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