Games

Export ongoing game of a user

Changed on Sep 19, 2026

Download the ongoing game, or the last game played, of a user. Available in either PGN or JSON format. Ongoing games are delayed by 3 moves, as to prevent cheat bots from using this API.

get/api/user/{username}/current-game

Request

Base URL
https://lichess.org
URL
https://lichess.org/api/user/{username}/current-game
Auth
none required

Path parameters

usernamestring required

Query parameters

movesboolean

Include the PGN moves.

pgnInJsonboolean

Include the full PGN within the JSON response, in a pgn field.

tagsboolean

Include the PGN tags.

clocksboolean

Include clock status when available. Either as PGN comments: 2. exd5 { [%clk 1:01:27] } e5 { [%clk 1:01:28] } Or in a clocks JSON field, as centisecond integers, depending on the response type.

evalsboolean

Include analysis evaluations and comments, when available. Either as PGN comments: 12. Bxf6 { [%eval 0.23] } a3 { [%eval -1.09] } Or in an analysis JSON field, depending on the response type.

accuracyboolean

Include accuracy percent of each player, when available. Only available in JSON.

openingboolean

Include the opening name. Example: [Opening "King's Gambit Accepted, King's Knight Gambit"]

divisionboolean

Plies which mark the beginning of the middlegame and endgame. Only available in JSON

literateboolean

Insert textual annotations in the PGN about the opening, analysis variations, mistakes, and game termination. Example: 5... g4? { (-0.98 → 0.60) Mistake. Best move was h6. } (5... h6 6. d4 Ne7 7. g3 d5 8. exd5 fxg3 9. hxg3 c6 10. dxc6)

Headers

Accept'application/x-chess-pgn' | 'application/json'

Specify the desired response format. Use application/x-chess-pgn to get the games in PGN format. Use application/json to get the games in JSON format.

Response

The ongoing (or last) game of a user. This may be in either PGN or JSON format, depending on the Accept header of your request.

string required

Changes

Sep 19, 20269c95384dd8b1 Revision changes
- info
  added the optional property ////////// to the response with the status
- info
  added the optional property ////////// to the response with the status
Sep 2, 20269b0422af5084 Revision changes
- breaking
  added to the ///// response property oneOf list for the response status
- breaking
  added to the ///// response property oneOf list for the response status
- breaking
  the ///// response's property type changed from object to no type for status
- breaking
  the ///// response's property type changed from object to no type for status
- breaking
  removed the required property ////// from the response with the status
- breaking
  removed the required property ////// from the response with the status
- breaking
  removed the required property ////// from the response with the status
- breaking
  removed the required property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status

Operation history