Export one game

GET

https://lichess.org/game/export/:gameId

GET

/game/export/:gameId

curl https://lichess.org/game/export/gameId

200Retrieved

{
  "id": "q7ZvsdUF",
  "rated": true,
  "variant": "standard",
  "speed": "blitz",
  "perf": "blitz",
  "createdAt": 1514505150384,
  "lastMoveAt": 1514505592843,
  "status": "draw",
  "players": {
    "white": {
      "user": {
        "id": "lance5500",
        "name": "Lance5500",
        "title": "LM"
      },
      "rating": 2389,
      "ratingDiff": 4,
      "analysis": {
        "inaccuracy": 5,
        "mistake": 2,
        "blunder": 1,
        "acpl": 26,
        "accuracy": 90
      }
    },
    "black": {
      "user": {
        "id": "tryinghard87",
        "name": "TryingHard87"
      },
      "rating": 2498,
      "ratingDiff": -4,
      "analysis": {
        "inaccuracy": 3,
        "mistake": 3,
        "blunder": 1,
        "acpl": 26,
        "accuracy": 90
      }
    }
  },
  "source": "arena",
  "opening": {
    "eco": "D31",
    "name": "Semi-Slav Defense: Marshall Gambit",
    "ply": 7
  },
  "moves": "d4 d5 c4 c6 Nc3 e6 e4 Nd7 exd5 cxd5 cxd5 exd5 Nxd5 Nb6 Bb5+ Bd7 Qe2+ Ne7 Nxb6 Qxb6 Bxd7+ Kxd7 Nf3 Qa6 Ne5+ Ke8 Qf3 f6 Nd3 Qc6 Qe2 Kf7 O-O Kg8 Bd2 Re8 Rac1 Nf5 Be3 Qe6 Rfe1 g6 b3 Bd6 Qd2 Kf7 Bf4 Qd7 Bxd6 Nxd6 Nc5 Rxe1+ Rxe1 Qc6 f3 Re8 Rxe8 Nxe8 Kf2 Nc7 Qb4 b6 Qc4+ Nd5 Nd3 Qe6 Nb4 Ne7 Qxe6+ Kxe6 Ke3 Kd6 g3 h6 Kd3 h5 Nc2 Kd5 a3 Nc6 Ne3+ Kd6 h4 Nd8 g4 Ne6 Ke4 Ng7 Nc4+ Ke6 d5+ Kd7 a4 g5 gxh5 Nxh5 hxg5 fxg5 Kf5 Nf4 Ne3 Nh3 Kg4 Ng1 Nc4 Kc7 Nd2 Kd6 Kxg5 Kxd5 f4 Nh3+ Kg4 Nf2+ Kf3 Nd3 Ke3 Nc5 Kf3 Ke6 Ke3 Kf5 Kd4 Ne6+ Kc4",
  "analysis": [
    {
      "eval": 8
    },
    {
      "eval": 7
    },
    {
      "eval": 10
    },
    {
      "eval": 14
    },
    {
      "eval": 2
    },
    {
      "eval": 9
    },
    {
      "eval": 5
    },
    {
      "eval": 85,
      "best": "d5e4",
      "variation": "dxe4 Nxe4 Bb4+ Nc3 c5 a3 Bxc3+ bxc3 Nc6 Nf3",
      "judgment": {
        "name": "Inaccuracy",
        "comment": "Inaccuracy. dxe4 was best."
      }
    },
    {
      "eval": 96
    },
    {
      "eval": 98
    },
    {
      "eval": 88
    },
    {
      "eval": 87
    },
    {
      "eval": 81
    },
    {
      "eval": 88
    },
    {
      "eval": 82
    },
    {
      "eval": 90
    },
    {
      "eval": 79
    },
    {
      "eval": 160,
      "best": "f8e7",
      "variation": "Be7 Nxb6 axb6 Nf3 Nf6 O-O O-O Bd2 Bd6 Bc4 Re8 Qd3 Be6 Bxe6",
      "judgment": {
        "name": "Inaccuracy",
        "comment": "Inaccuracy. Be7 was best."
      }
    },
    {
      "eval": 146
    },
    {
      "eval": 151
    },
    {
      "eval": 149
    },
    {
      "eval": 160
    },
    {
      "eval": 151
    },
    {
      "eval": 150
    },
    {
      "eval": 164
    },
    {
      "eval": 190
    },
    {
      "eval": 44,
      "best": "e5d3",
      "variation": "Nd3 Rd8",
      "judgment": {
        "name": "Mistake",
        "comment": "Mistake. Nd3 was best."
      }
    },
    {
      "eval": 61
    },
    {
      "eval": 59
    },
    {
      "eval": 54
    },
    {
      "eval": -34,
      "best": "e1e2",
      "variation": "Ke2 Rd8 Rd1 Qxf3+ Kxf3 Nf5 Be3 Nh4+ Kg3 g5 f4 gxf4+ Bxf4 Nf5+",
      "judgment": {
        "name": "Inaccuracy",
        "comment": "Inaccuracy. Ke2 was best."
      }
    },
    {
      "eval": 158,
      "best": "c6g2",
      "variation": "Qxg2 Rf1 Qd5 Be3 Rc8 Nf4 Qf5 Rc1 Rxc1+ Bxc1 g5 Ne6 Kf7 Nd8+",
      "judgment": {
        "name": "Blunder",
        "comment": "Blunder. Qxg2 was best."
      }
    },
    {
      "eval": 142
    },
    {
      "eval": 183
    },
    {
      "eval": 177
    },
    {
      "eval": 340,
      "best": "e7d5",
      "variation": "Nd5 Rac1 Qe8 Qf3 Rd8 Nf4 Qf7 Nxd5 Qxd5 Qxd5+ Rxd5 Rc7 Rxd4 Bc3",
      "judgment": {
        "name": "Mistake",
        "comment": "Mistake. Nd5 was best."
      }
    },
    {
      "eval": 169,
      "best": "f1e1",
      "variation": "Rfe1 Rc8 Rac1 Qd7 Nf4 Rxc1 Rxc1 h5 Qd3 a5 Qb3+ Kh7 Rc5 Nf5",
      "judgment": {
        "name": "Mistake",
        "comment": "Mistake. Rfe1 was best."
      }
    },
    {
      "eval": 200
    },
    {
      "eval": 120,
      "best": "e2h5",
      "variation": "Qh5 Qd7 Rc7 Qxc7 Qxe8 Qc6 Qd8 h6 Bb4 Qe4 Ne1 Kf7 Nf3 Qc6",
      "judgment": {
        "name": "Inaccuracy",
        "comment": "Inaccuracy. Qh5 was best."
      }
    },
    {
      "eval": 167
    },
    {
      "eval": 147
    },
    {
      "eval": 200,
      "best": "e6d7",
      "variation": "Qd7 Nf4"
    },
    {
      "eval": 92,
      "best": "c1c7",
      "variation": "Rc7 Qxa2",
      "judgment": {
        "name": "Inaccuracy",
        "comment": "Inaccuracy. Rc7 was best."
      }
    },
    {
      "eval": 102
    },
    {
      "eval": 95
    },
    {
      "eval": 95
    },
    {
      "eval": 61
    },
    {
      "eval": 79
    },
    {
      "eval": 72
    },
    {
      "eval": 201,
      "best": "d7d6",
      "variation": "Qxd6 d5 Rxe1+ Rxe1 Re8 Rxe8 Kxe8 Nf4 Qe5 g3 Nd4 Qc3 Kd7 Qb4",
      "judgment": {
        "name": "Mistake",
        "comment": "Mistake. Qxd6 was best."
      }
    },
    {
      "eval": 190
    },
    {
      "eval": 183
    },
    {
      "eval": 106,
      "best": "d2e1",
      "variation": "Qxe1 Qe7 Qxe7+ Kxe7 Nxb7 Rc8 Re1+ Kd7 Nc5+ Kc6 g3 Re8 Rc1 Kd5",
      "judgment": {
        "name": "Inaccuracy",
        "comment": "Inaccuracy. Qxe1 was best."
      }
    },
    {
      "eval": 108
    },
    {
      "eval": 93
    },
    {
      "eval": 101
    },
    {
      "eval": 101
    },
    {
      "eval": 107
    },
    {
      "eval": 100
    },
    {
      "eval": 105
    },
    {
      "eval": 103
    },
    {
      "eval": 118
    },
    {
      "eval": 117
    },
    {
      "eval": 116
    },
    {
      "eval": 83
    },
    {
      "eval": 95
    },
    {
      "eval": 90
    },
    {
      "eval": 94
    },
    {
      "eval": 94
    },
    {
      "eval": 93
    },
    {
      "eval": 88
    },
    {
      "eval": 102
    },
    {
      "eval": 79
    },
    {
      "eval": 120
    },
    {
      "eval": 114
    },
    {
      "eval": 124
    },
    {
      "eval": 108
    },
    {
      "eval": 133
    },
    {
      "eval": 100
    },
    {
      "eval": 156,
      "best": "d5d6",
      "variation": "Kd6 Kc4"
    },
    {
      "eval": 198
    },
    {
      "eval": 179
    },
    {
      "eval": 167
    },
    {
      "eval": 227,
      "best": "c6a5",
      "variation": "Na5 b4"
    },
    {
      "eval": 225
    },
    {
      "eval": 209
    },
    {
      "eval": 207
    },
    {
      "eval": 192
    },
    {
      "eval": 173
    },
    {
      "eval": 243,
      "best": "d6c6",
      "variation": "Kc6 a4 a6 Ne3 Kd6 d5 Kd7 Kd4 Ne8 gxh5 gxh5 Nf5 Nd6 Ng3",
      "judgment": {
        "name": "Inaccuracy",
        "comment": "Inaccuracy. Kc6 was best."
      }
    },
    {
      "eval": 219
    },
    {
      "eval": 234
    },
    {
      "eval": 201
    },
    {
      "eval": 342,
      "best": "d7e7",
      "variation": "Ke7 Kf4 Ne8 g5 Kf7 gxf6 Kxf6 Nd2 Ng7 Ne4+ Ke7 Kg5 Nf5 d6+",
      "judgment": {
        "name": "Mistake",
        "comment": "Mistake. Ke7 was best."
      }
    },
    {
      "eval": 318
    },
    {
      "eval": 342
    },
    {
      "eval": 307
    },
    {
      "eval": 323
    },
    {
      "eval": 270
    },
    {
      "eval": 313
    },
    {
      "eval": 279
    },
    {
      "eval": 303
    },
    {
      "eval": 286
    },
    {
      "eval": 277
    },
    {
      "eval": 215
    },
    {
      "eval": 213
    },
    {
      "eval": 8,
      "best": "b3b4",
      "variation": "b4 Kc8 Nd6+ Kd7 Ne4 a6 Nc3 Kd6 Kg3 Ke5 b5 axb5 axb5 Kd6",
      "judgment": {
        "name": "Blunder",
        "comment": "Blunder. b4 was best."
      }
    },
    {
      "eval": 8
    },
    {
      "eval": 8
    },
    {
      "eval": 8
    },
    {
      "eval": 21
    },
    {
      "eval": 54
    },
    {
      "eval": 42
    },
    {
      "eval": 57
    },
    {
      "eval": 25
    },
    {
      "eval": 63
    },
    {
      "eval": 8,
      "best": "f3g4",
      "variation": "Kg4 Nf2+ Kf5 Kd4 Nf3+ Kc3 Ke6 Kxb3 f5 Ne4 Ke5 Nf2 Kf4 Nd3+",
      "judgment": {
        "name": "Inaccuracy",
        "comment": "Inaccuracy. Kg4 was best."
      }
    },
    {
      "eval": 8
    },
    {
      "eval": 8
    },
    {
      "eval": 8
    },
    {
      "eval": 8
    },
    {
      "eval": 8
    },
    {
      "eval": 8
    },
    {
      "eval": 8
    },
    {
      "eval": 8
    }
  ],
  "tournament": "winter17",
  "clock": {
    "initial": 300,
    "increment": 3,
    "totalTime": 420
  },
  "division": {
    "middle": 22,
    "end": 53
  }
}

Download one game in either PGN or JSON format. Ongoing games are delayed by a few seconds ranging from 3 to 60 depending on the time control, as to prevent cheat bots from using this API.

Path parameters

gameIdstringRequired=8 characters

The game ID

Query parameters

movesbooleanOptionalDefaults to true

Include the PGN moves.

pgnInJsonbooleanOptionalDefaults to false

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

tagsbooleanOptionalDefaults to true

Include the PGN tags.

clocksbooleanOptionalDefaults to true

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.

evalsbooleanOptionalDefaults to true

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.

accuracybooleanOptionalDefaults to false

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

openingbooleanOptionalDefaults to true

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

divisionbooleanOptionalDefaults to true

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

literatebooleanOptionalDefaults to false

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)

withBookmarkedbooleanOptionalDefaults to false

Add a bookmarked: true JSON field when the logged in user has bookmarked the game. The response type must be set to application/x-ndjson by the request Accept header.

Response

The game representation.

idstring

ratedboolean

variantenumDefaults to standard

speedenum

perfstring

createdAtlong

lastMoveAtlong

statusenum

playersobject

sourcestringOptional

initialFenstringOptional

winnerenumOptional

Allowed values:

openingobjectOptional

movesstringOptional

pgnstringOptional

daysPerTurnintegerOptional

analysislist of objectsOptional

tournamentstringOptional

swissstringOptional

clockobjectOptional

clockslist of integersOptional

divisionobjectOptional