Start the Lichess OAuth login flow. Opens a browser for authorization. Use this to connect, sign in, or authenticate your Lichess chess account.

Check if you are authenticated with Lichess and return account info. Use this to verify login status or confirm which Lichess chess account is connected.

Get your Lichess account profile, ratings, and stats. Returns your chess rating, username, and performance across bullet, blitz, rapid, and classical time controls.

Get a Lichess user's public chess profile, ratings, and stats by username. Look up any player on Lichess.

Fetch your recent chess games from Lichess. Returns game history including moves, result, opponent, time control, and opening. Filter by color (white/black) or rated/casual.

Get your currently active or in-progress chess games on Lichess. Lists all games you are currently playing, including board position and whose turn it is.

Challenge a Lichess player to a chess game. Send a game invite with custom time control (bullet, blitz, rapid, classical, correspondence), color choice, and rated or casual.

Play a chess move in an active Lichess game using UCI notation (e.g. e2e4, d7d5, e7e8q for promotion). Submit your move during a live game.

Stream the live board state, moves, and game events for an ongoing Lichess chess game. Get real-time updates including position, clocks, and chat.

Resign and forfeit an active Lichess chess game. Concedes the game to your opponent.

Offer, accept, or decline a draw in an active Lichess chess game. Propose a draw to your opponent or respond to their draw offer.

Get Lichess cloud engine evaluation for a chess position in FEN notation. Returns the best move, score, and top lines from Stockfish cloud analysis.

Get today's Lichess daily chess puzzle. Returns the position, solution, and puzzle metadata for the puzzle of the day.

Get a specific Lichess chess puzzle by ID. Returns the board position, moves, theme, and difficulty rating for the puzzle.

List your incoming and outgoing chess challenges on Lichess. See pending game invites you have received or sent.

Accept an incoming chess challenge on Lichess. Start the game with the challenger.

Decline an incoming chess challenge on Lichess. Optionally provide a reason.

Cancel an outgoing chess challenge you sent on Lichess.

Challenge the Lichess AI (Stockfish) to a chess game. Choose difficulty level 1–8, time control, color, and variant.

Abort an active Lichess chess game before it has started properly. Only works in the first few moves.

Request, accept, or decline a takeback (undo last move) in an active Lichess chess game.

Send a chat message in an active Lichess chess game, to the player or spectator chat room.

Stream incoming Lichess events such as game starts, incoming challenges, and correspondence game moves.

Get your next recommended Lichess chess puzzle based on your puzzle rating and history.

Get your Lichess puzzle activity history — recent puzzles you attempted, results, ratings, and themes.

Get the chess rating history over time for a Lichess player across all time controls (bullet, blitz, rapid, classical, etc.).

Get the head-to-head record between two Lichess players. Shows total games and score for each player.

Get the Lichess leaderboard — top players by rating for a specific time control (bullet, blitz, rapid, classical, chess960, etc.).