Lichess API

15 endpoints for Lichess, each at its own method and path, called with your API key. Open an endpoint for its inputs, examples and response.

Base URL
https://cotlet.dev/api/v1/lichess
Connects with
Your own Lichess account. Team tools need a team leader role, and sending team updates needs the Updates permission. You sign in yourself in your Cloud Browser; Cotlet never plays moves for you.
Integration page
Lichess

Read (8)

Return data and change nothing in the account.

Lichess Endpoints: Read
EndpointDescription
GET /account Return the signed-in Lichess profile: username, title, ratings per game type and account dates.
GET /user-teams List the teams a user belongs to, with member counts and which ones they lead.
GET /team-join-requests List pending requests to join a team you lead, with each applicant's message and profile.
GET /arena-tournaments List recently active, running and upcoming Arena tournaments from the Lichess schedule.
GET /tournaments/{tournament_id}/arena-results Return the final standings of an Arena tournament: rank, score, rating and performance per player.
GET /studies List the studies of a user with their IDs, names and update dates.
GET /user-games/export Export the games of a user as PGN or JSON, newest first, filtered by date, game type, color and opponent.
GET /broadcasts List the broadcasts a user created, with their rounds and start dates.

Write (7)

Change the account. Calls marked Confirm wait for the user to approve them.

Lichess Endpoints: Write
EndpointDescription
POST /teams/{team_id}/join-request/accept Confirm Accept one person's request to join a team you lead.
POST /teams/{team_id}/join-request/decline Confirm Decline one person's request to join a team you lead.
POST /teams/{team_id}/update Confirm Send a message to all members of a team you lead.
POST /arena-tournaments Confirm Create a public or private Arena tournament with a clock, length, start time and entry rules.
POST /studies/{study_id}/pgn-to-studies Confirm Add a PGN as new chapters to a study you own or can edit.
POST /broadcasts Confirm Create a broadcast for an over-the-board event, to which rounds are added next.
POST /broadcasts/{broadcast_id}/round Confirm Add a round to a broadcast, fed from a PGN URL, Lichess game IDs or Lichess usernames.

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.