Get Daily Puzzle

Get the daily puzzle in standard and API formats

Endpoint

Standard Format

GET https://lichess.org/api/puzzle/daily

Description

Fetch the daily puzzle. The endpoint returns a new puzzle each day at midnight UTC.

The daily puzzle is a carefully selected tactical puzzle that changes once per day and is the same for all users.

Authentication

No authentication required. This endpoint is publicly accessible.

Response

game · object · required

Game information where the puzzle originated

Show properties

id · string

The game ID from which this puzzle was extracted

pgn · string

The PGN (Portable Game Notation) of the game

perf · object

Performance category information

Show properties

key · string

Performance type key (e.g., “blitz”, “rapid”)

name · string

Human-readable performance type name

players · array

Array of player objects for white and black

puzzle · object · required

The puzzle data

Show properties

id · string

Unique puzzle identifier (5-character alphanumeric)

rating · integer

The puzzle difficulty rating (similar to Glicko rating)

plays · integer

Number of times this puzzle has been attempted by users

initialPly · integer

The ply (half-move) count at which the puzzle position starts

solution · array

Array of UCI move strings representing the puzzle solution

themes · array

Array of theme keys (e.g., “fork”, “pin”, “skewer”) describing the puzzle’s tactical motifs

Example Request

cURL

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

Example Response

{
  "game": {
    "id": "yH1M0p8x",
    "perf": {
      "key": "rapid",
      "name": "Rapid"
    },
    "pgn": "e4 e5 Nf3 Nc6 Bb5 a6 Ba4 Nf6 O-O Be7...",
    "players": [
      {
        "color": "white",
        "name": "PlayerOne",
        "userId": "playerone"
      },
      {
        "color": "black",
        "name": "PlayerTwo",
        "userId": "playertwo"
      }
    ]
  },
  "puzzle": {
    "id": "a1b2c",
    "rating": 1847,
    "plays": 12453,
    "initialPly": 42,
    "solution": ["e4e5", "f6e4", "d1h5"],
    "themes": ["middlegame", "fork", "short"]
  }
}

Notes

• The daily puzzle changes at midnight UTC
• The puzzle is the same for all users on a given day
• No authentication required
• Rate limiting applies as per standard API limits
• The HTML endpoint /training/daily provides a user-friendly web interface

Related Endpoints

• Get Puzzle Activity - Get user’s puzzle solving activity
• Get Puzzle Dashboard - Get user’s puzzle performance dashboard