org.lichess.puzzle.getDaily Documentation (EN)

main query

Get the puzzle of the day: one shared puzzle per UTC day, selected to target the current average rating of established players and to favor popular, frequently-played puzzles. The pick is stable for the whole UTC day and never repeats a previous day's puzzle.

Output

Encodingapplication/json

day string Required

the UTC day the puzzle belongs to, as YYYY-MM-DD.

puzzle reforg.lichess.puzzle.defs#puzzleView Required

No description available.

Errors

NoDailyPuzzle No puzzle could be selected for the day.

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Service Endpoint Base URL for XRPC calls (e.g., https://api.bsky.social)

View raw schema

{
  "type": "query",
  "errors": [
    {
      "name": "NoDailyPuzzle",
      "description": "No puzzle could be selected for the day."
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "day",
        "puzzle"
      ],
      "properties": {
        "day": {
          "type": "string",
          "description": "the UTC day the puzzle belongs to, as YYYY-MM-DD."
        },
        "puzzle": {
          "ref": "org.lichess.puzzle.defs#puzzleView",
          "type": "ref"
        }
      }
    },
    "encoding": "application/json"
  },
  "description": "Get the puzzle of the day: one shared puzzle per UTC day, selected to target the current average rating of established players and to favor popular, frequently-played puzzles. The pick is stable for the whole UTC day and never repeats a previous day's puzzle."
}