---
title: "Get best ongoing games of a TV channel"
method: GET
path: "/api/tv/{channel}"
tags: ["TV"]
---

# Get best ongoing games of a TV channel

`GET /api/tv/{channel}`

Get a list of ongoing games for a given TV channel. Similar to [lichess.org/games](https://lichess.org/games).
Available in PGN or [ndjson](#description/streaming-with-nd-json) format, depending on the request `Accept` header.

## Path parameters

- `channel` string, required

## Query parameters

- `nb` integer
- `moves` boolean
- `pgnInJson` boolean
- `tags` boolean
- `clocks` boolean
- `opening` boolean

## Headers

- `Accept` 'application/x-chess-pgn' | 'application/x-ndjson'

## Response `200`

The representation of the games.

## Changes

- **2026-09-02** `9b0422af5084` — 8 breaking, 12 warning
  - added `#/components/schemas/GamePlayerUser, #/components/schemas/GamePlayerAi` to the `players/black` response property `oneOf` list for the response status `200` (media type: application/x-ndjson)
  - added `#/components/schemas/GamePlayerUser, #/components/schemas/GamePlayerAi` to the `players/white` response property `oneOf` list for the response status `200` (media type: application/x-ndjson)
  - the `players/black` response's property type changed from `object` to no type for status `200` (media type: application/x-ndjson)
  - the `players/white` response's property type changed from `object` to no type for status `200` (media type: application/x-ndjson)
  - …16 more

[Change history](https://skmtc.dev/lichess/apis/lichess-org-api-reference/changes/api/tv/:channel/get.md)

---

[API](https://skmtc.dev/lichess/apis/lichess-org-api-reference.md) · [All operations](https://skmtc.dev/lichess/apis/lichess-org-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lichess/lichess-org-api-reference/revisions/9b0422af5084/schema)