Get a puzzle by its ID

GET

https://lichess.org/api/puzzle/:id

GET

/api/puzzle/:id

curl https://lichess.org/api/puzzle/id

200Retrieved

{
  "game": {
    "clock": "3+0",
    "id": "AHGPPS44",
    "perf": {
      "key": "blitz",
      "name": "Blitz"
    },
    "pgn": "d4 d5 Bf4 Bf5 Nf3 e6 c4 Nf6 Nc3 Bd6 Bg3 Nbd7 e3 O-O c5 Bxg3 hxg3 h6 Bd3 Ne4 Qc2 Ndf6 Nd2 Nxc3 Bxf5 exf5 bxc3 Ne4 Nxe4 fxe4 Rb1 b6 Rh5 bxc5 Rb5 cxd4 cxd4 c6 Qxc6 Rc8 Qxd5 Qf6 Qxe4 Rc1+ Ke2 Qa6 Qd5 Rc2+ Kf3 g6 Rxh6 Qf6+ Ke4",
    "players": [
      {
        "color": "white",
        "id": "ericrosen",
        "name": "EricRosen",
        "rating": 2642,
        "flair": "travel-places.ambulance",
        "patronColor": 10,
        "title": "IM",
        "patron": true
      },
      {
        "color": "black",
        "id": "anton_volovikov",
        "name": "Anton_Volovikov",
        "rating": 2619,
        "title": "FM"
      }
    ],
    "rated": true
  },
  "puzzle": {
    "id": "PSjmf",
    "initialPly": 52,
    "plays": 716,
    "rating": 2774,
    "solution": [
      "g8g7",
      "d5e5",
      "f6e5"
    ],
    "themes": [
      "endgame",
      "master",
      "short",
      "masterVsMaster",
      "crushing"
    ]
  }
}

Get a single Lichess puzzle in JSON format.

Path parameters

idstringRequired

The puzzle ID

Response

The requested puzzle.

gameobject

puzzleobject