v3

OpenAPI 3.1.0AGPL-3.0-or-later2026-07-311871891.1 MB
Broadcasts

Get paginated top broadcast previews

The same data, in the same order, as can be seen on https://lichess.org/broadcast.

get/api/broadcast/top

Query parameters

pageinteger

Which page to fetch. Only page 1 has "active" broadcasts.

htmlboolean

Convert the "description" field from markdown to HTML

Response

Paginated top broadcast previews.

Example response

{
  "active": [
    {
      "tour": {
        "createdAt": 1722169800000,
        "dates": [
          1722169800000,
          1722666600000
        ]
      }
    }
  ],
  "upcoming": [
    {
      "tour": {
        "createdAt": 1722169800000,
        "dates": [
          1722169800000,
          1722666600000
        ]
      }
    }
  ],
  "past": {
    "currentPage": 4,
    "maxPerPage": 20,
    "currentPageResults": [
      {
        "tour": {
          "createdAt": 1722169800000,
          "dates": [
            1722169800000,
            1722666600000
          ]
        }
      }
    ],
    "previousPage": 3,
    "nextPage": 5
  }
}