Get Daily Puzzle

Endpoint

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

GET https://lichess.org/training/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

object

required

Game information where the puzzle originated

Show properties

string

The game ID from which this puzzle was extracted

string

The PGN (Portable Game Notation) of the game

object

Performance category information

Show properties

string

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

string

Human-readable performance type name

array

Array of player objects for white and black

object

required

The puzzle data

Show properties

string

Unique puzzle identifier (5-character alphanumeric)

integer

The puzzle difficulty rating (similar to Glicko rating)

integer

Number of times this puzzle has been attempted by users

integer

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

array

Array of UCI move strings representing the puzzle solution

array

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

Example Request

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

const response = await fetch('https://lichess.org/api/puzzle/daily');
const dailyPuzzle = await response.json();
console.log(dailyPuzzle);

import requests

response = requests.get('https://lichess.org/api/puzzle/daily')
daily_puzzle = response.json()
print(daily_puzzle)

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

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

Getting Started

Games

Users

Tournaments

Studies

Puzzles

Broadcasts

TV & Streaming

Bot API

Get Daily Puzzle

Endpoint

Description

Authentication

Response

Example Request

Example Response

Notes

​Endpoint

​Description

​Authentication

​Response

​Example Request

​Example Response

​Notes

​Related Endpoints

Endpoint

Description

Authentication

Response

Example Request

Example Response

Notes

Related Endpoints