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
| Name | Type | Description |
|---|---|---|
| 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 https://cotlet.dev/api/v1/lichess/broadcasts \
-H "Authorization: Bearer $COTLET_API_KEY" result = client.call("lichess", "list_broadcasts") const result = await cotlet.call('lichess', 'list_broadcasts'); cotlet call lichess list_broadcasts Example response
{
"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"
}
]
}
]
}