---
title: "Get paginated top broadcast previews"
method: GET
path: "/api/broadcast/top"
tags: ["Broadcasts"]
---

# Get paginated top broadcast previews

`GET /api/broadcast/top`

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

## Query parameters

- `page` integer
- `html` boolean

## Response `200`

Paginated top broadcast previews.

- BroadcastTop
  - `active` BroadcastWithLastRound[]
    - `group` string
    - `tour` BroadcastTour
      - `id` string, required
      - `name` string, required
      - `slug` string, required
      - `createdAt` integer, required
      - `dates` integer[] — Start and end dates of the tournament, as Unix timestamps in milliseconds
      - `info` BroadcastTourInfo — Additional display information about the tournament
        - `format` string — Tournament format. Example: `"8-player round-robin" or "5-round Swiss"`
        - `tc` string — Time control. Example: `"Classical" or "Rapid" or "Rapid & Blitz"`
        - `fideTC` 'standard' | 'rapid' | 'blitz' — FIDE rating category
        - `timeZone` string — Timezone of the tournament. Example: `America/New_York`. See [list of possible timezone identifiers](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) for more.
        - `location` string — Tournament location
        - `players` string — Mentioning up to 4 of the best players participating.
        - `website` string, uri — Official website. External website URL
        - `standings` string, uri — Official standings website. External website URL, e.g. chess-results.com, info64.org
        - `regulations` string, uri — External URL to the official tournament regulations.
      - `tier` integer — Used to designate featured tournaments on Lichess
      - `image` string, uri
      - `description` string — Full tournament description in markdown format, or in HTML if the html=1 query parameter is set.
      - `teamTable` boolean
      - `showTeamScores` boolean
      - `url` string, uri, required
      - `communityOwner` LightUser
        - `id` string, required
        - `name` string, required
        - `flair` string — See [available flair list and images](https://github.com/lichess-org/lila/tree/master/public/flair)
        - `title` 'GM' | 'WGM' | 'IM' | 'WIM' | 'FM' | 'WFM' | 'NM' | 'CM' | 'WCM' | 'WNM' | 'LM' | 'BOT' — only appears if the user is a titled player or a bot user
        - `patron` boolean — Use patronColor value instead to determine if player is a patron.
        - `patronColor` integer — Players can choose a color for their Patron wings. See [here for the color mappings](https://github.com/lichess-org/lila/blob/master/ui/lib/css/abstract/_patron-colors.scss). The presence of this field indicates the player is an active Patron.
    - `round` BroadcastRoundInfo
      - `id` string, required
      - `name` string, required
      - `slug` string, required
      - `createdAt` integer, required
      - `rated` boolean, required — Whether the round is used for rating calculations
      - `ongoing` boolean
      - `startsAt` integer
      - `startsAfterPrevious` boolean — The start date/time is unknown and the round will start automatically when the previous round completes
      - `finishedAt` integer
      - `finished` boolean
      - `url` string, uri, required
      - `delay` integer
      - `customScoring` BroadcastCustomScoring — Scoring overrides for wins or draws.
        - `white` BroadcastCustomPointsPerColor, required
          - `win` number, required
          - `draw` number, required
        - `black` BroadcastCustomPointsPerColor, required
          - `win` number, required
          - `draw` number, required
  - `upcoming` BroadcastWithLastRound[]
    - `group` string
    - `tour` BroadcastTour
      - `id` string, required
      - `name` string, required
      - `slug` string, required
      - `createdAt` integer, required
      - `dates` integer[] — Start and end dates of the tournament, as Unix timestamps in milliseconds
      - `info` BroadcastTourInfo — Additional display information about the tournament
        - `format` string — Tournament format. Example: `"8-player round-robin" or "5-round Swiss"`
        - `tc` string — Time control. Example: `"Classical" or "Rapid" or "Rapid & Blitz"`
        - `fideTC` 'standard' | 'rapid' | 'blitz' — FIDE rating category
        - `timeZone` string — Timezone of the tournament. Example: `America/New_York`. See [list of possible timezone identifiers](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) for more.
        - `location` string — Tournament location
        - `players` string — Mentioning up to 4 of the best players participating.
        - `website` string, uri — Official website. External website URL
        - `standings` string, uri — Official standings website. External website URL, e.g. chess-results.com, info64.org
        - `regulations` string, uri — External URL to the official tournament regulations.
      - `tier` integer — Used to designate featured tournaments on Lichess
      - `image` string, uri
      - `description` string — Full tournament description in markdown format, or in HTML if the html=1 query parameter is set.
      - `teamTable` boolean
      - `showTeamScores` boolean
      - `url` string, uri, required
      - `communityOwner` LightUser
        - `id` string, required
        - `name` string, required
        - `flair` string — See [available flair list and images](https://github.com/lichess-org/lila/tree/master/public/flair)
        - `title` 'GM' | 'WGM' | 'IM' | 'WIM' | 'FM' | 'WFM' | 'NM' | 'CM' | 'WCM' | 'WNM' | 'LM' | 'BOT' — only appears if the user is a titled player or a bot user
        - `patron` boolean — Use patronColor value instead to determine if player is a patron.
        - `patronColor` integer — Players can choose a color for their Patron wings. See [here for the color mappings](https://github.com/lichess-org/lila/blob/master/ui/lib/css/abstract/_patron-colors.scss). The presence of this field indicates the player is an active Patron.
    - `round` BroadcastRoundInfo
      - `id` string, required
      - `name` string, required
      - `slug` string, required
      - `createdAt` integer, required
      - `rated` boolean, required — Whether the round is used for rating calculations
      - `ongoing` boolean
      - `startsAt` integer
      - `startsAfterPrevious` boolean — The start date/time is unknown and the round will start automatically when the previous round completes
      - `finishedAt` integer
      - `finished` boolean
      - `url` string, uri, required
      - `delay` integer
      - `customScoring` BroadcastCustomScoring — Scoring overrides for wins or draws.
        - `white` BroadcastCustomPointsPerColor, required
          - `win` number, required
          - `draw` number, required
        - `black` BroadcastCustomPointsPerColor, required
          - `win` number, required
          - `draw` number, required
  - `past` object
    - `currentPage` integer
    - `maxPerPage` integer
    - `currentPageResults` BroadcastWithLastRound[]
      - `group` string
      - `tour` BroadcastTour
        - `id` string, required
        - `name` string, required
        - `slug` string, required
        - `createdAt` integer, required
        - `dates` integer[] — Start and end dates of the tournament, as Unix timestamps in milliseconds
        - `info` BroadcastTourInfo — Additional display information about the tournament
          - `format` string — Tournament format. Example: `"8-player round-robin" or "5-round Swiss"`
          - `tc` string — Time control. Example: `"Classical" or "Rapid" or "Rapid & Blitz"`
          - `fideTC` 'standard' | 'rapid' | 'blitz' — FIDE rating category
          - `timeZone` string — Timezone of the tournament. Example: `America/New_York`. See [list of possible timezone identifiers](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) for more.
          - `location` string — Tournament location
          - `players` string — Mentioning up to 4 of the best players participating.
          - `website` string, uri — Official website. External website URL
          - `standings` string, uri — Official standings website. External website URL, e.g. chess-results.com, info64.org
          - `regulations` string, uri — External URL to the official tournament regulations.
        - `tier` integer — Used to designate featured tournaments on Lichess
        - `image` string, uri
        - `description` string — Full tournament description in markdown format, or in HTML if the html=1 query parameter is set.
        - `teamTable` boolean
        - `showTeamScores` boolean
        - `url` string, uri, required
        - `communityOwner` LightUser
          - `id` string, required
          - `name` string, required
          - `flair` string — See [available flair list and images](https://github.com/lichess-org/lila/tree/master/public/flair)
          - `title` 'GM' | 'WGM' | 'IM' | 'WIM' | 'FM' | 'WFM' | 'NM' | 'CM' | 'WCM' | 'WNM' | 'LM' | 'BOT' — only appears if the user is a titled player or a bot user
          - `patron` boolean — Use patronColor value instead to determine if player is a patron.
          - `patronColor` integer — Players can choose a color for their Patron wings. See [here for the color mappings](https://github.com/lichess-org/lila/blob/master/ui/lib/css/abstract/_patron-colors.scss). The presence of this field indicates the player is an active Patron.
      - `round` BroadcastRoundInfo
        - `id` string, required
        - `name` string, required
        - `slug` string, required
        - `createdAt` integer, required
        - `rated` boolean, required — Whether the round is used for rating calculations
        - `ongoing` boolean
        - `startsAt` integer
        - `startsAfterPrevious` boolean — The start date/time is unknown and the round will start automatically when the previous round completes
        - `finishedAt` integer
        - `finished` boolean
        - `url` string, uri, required
        - `delay` integer
        - `customScoring` BroadcastCustomScoring — Scoring overrides for wins or draws.
          - `white` BroadcastCustomPointsPerColor, required
            - `win` number, required
            - `draw` number, required
          - `black` BroadcastCustomPointsPerColor, required
            - `win` number, required
            - `draw` number, required
    - `previousPage` integer, nullable
    - `nextPage` integer, nullable

---

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