List broadcasts of a user

List the broadcasts a user created, with their rounds and start dates.

GET https://cotlet.dev/api/v1/lichess/broadcasts

read

Returns broadcasts newest first, each with its ID, name, visibility and rounds with start dates. Use it to find an existing broadcast before adding a round. It reads only.

Parameters

Parameters: list_broadcasts
NameTypeDescription
username string string Lichess username. Defaults to the signed-in account, which also returns private and unlisted broadcasts.
page integer integer Page number, starting at 1.

Request

cURL
curl https://cotlet.dev/api/v1/lichess/broadcasts \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("lichess", "list_broadcasts")
Node.js
const result = await cotlet.call('lichess', 'list_broadcasts');
CLI
cotlet call lichess list_broadcasts

Example response

JSON

{
  "page": 1,
  "broadcasts": [
    {
      "broadcast_id": "Zp4tNc6h",
      "name": "Riverside Chess Club Championship 2026",
      "visibility": "private",
      "rounds": [
        {
          "round_id": "Kf3nQ8vD",
          "name": "Round 1",
          "starts_at": "2026-10-24T10:00:00Z"
        }
      ]
    }
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.