v4

latestOpenAPI 3.1.0AGPL-3.0-or-later2026-08-041901951.1 MB
Broadcasts

Stream ongoing broadcast rounds of a tournament as PGN

For a given broadcast tournament (example), selects all the ongoing and recently finished rounds, and sends all games of these rounds in PGN format. Then, it waits for new moves to be played. As soon as it happens, the entire PGN of the game is sent to the stream. The stream will also send PGNs when games are added to the rounds. This is the best way to get updates about an ongoing broadcast tournament across all its rounds. To stream a single round, use this endpoint instead.

get/api/stream/broadcast/tour/{broadcastTourId}.pgn

Path parameters

broadcastTourIdstring required

The broadcast tournament ID. It's the last past of the tournament URL, which can be found on the broadcast page overview section. Example the tournament URL is https://lichess.org/broadcast/sparkassen-chess-trophy-2026-open-a/jfEpUuzg and therefore the tournament ID is jfEpUuzg .

Query parameters

clocksboolean

Include clock comments in the PGN moves, when available. Example: 2. exd5 { [%clk 1:01:27] } e5 { [%clk 1:01:28] }

commentsboolean

Include analysis comments in the PGN moves, when available. Example: 12. Bxf6 { [%eval 0.23] }

Response

The PGN representation of the rounds games, then the PGNs of games as they are updated.