---
title: "Get broadcasts created by a user"
method: GET
path: "/api/broadcast/by/{username}"
tags: ["Broadcasts"]
---

# Get broadcasts created by a user

`GET /api/broadcast/by/{username}`

Get all incoming, ongoing, and finished official broadcasts.
The broadcasts are sorted by created date, most recent first.

If you are authenticated as the user whose broadcasts you are requesting, you will also see your private and unlisted broadcasts.

## Path parameters

- `username` string, required

## Query parameters

- `page` integer
- `html` boolean

## Response `200`

A paginated list of the broadcasts created by a user.

- object
  - `currentPage` integer, required
  - `maxPerPage` integer, required
  - `currentPageResults` BroadcastByUser[], required
    - `tour` BroadcastTour, required
      - `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.
  - `nbResults` integer, required
  - `previousPage` integer, nullable, required
  - `nextPage` integer, nullable, required
  - `nbPages` integer, required

---

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