List Arena tournaments
List recently active, running and upcoming Arena tournaments from the Lichess schedule.
GET https://cotlet.dev/api/v1/lichess/arena-tournaments
read
Returns each tournament with its ID, name, creator, clock, length in minutes, rated flag, variant, player count and start time, grouped as upcoming, started and finished. Use it to avoid creating a duplicate. It reads only.
Parameters
| Name | Type | Description |
|---|---|---|
| created_by string | string | Only tournaments created by this username. |
Request
curl https://cotlet.dev/api/v1/lichess/arena-tournaments \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("lichess", "list_arena_tournaments")const result = await cotlet.call('lichess', 'list_arena_tournaments');cotlet call lichess list_arena_tournamentsExample response
{
"upcoming": [
{
"tournament_id": "Qx7pLm2a",
"name": "Friday Blitz Night",
"created_by": "club_captain",
"clock": "3+0",
"minutes": 60,
"rated": true,
"variant": "standard",
"players": 12,
"starts_at": "2026-10-23T19:00:00Z"
}
],
"started": [],
"finished": []
}