org.lichess.puzzle.getThemes Documentation (EN)

main query

List all puzzle themes with their display names and descriptions. The keys returned here are the values accepted by the getRandom themes filter.

Output

Encodingapplication/json

themes array Required

all known puzzle themes.

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",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "themes"
      ],
      "properties": {
        "themes": {
          "type": "array",
          "items": {
            "ref": "org.lichess.puzzle.defs#themeView",
            "type": "ref"
          },
          "description": "all known puzzle themes."
        }
      }
    },
    "encoding": "application/json"
  },
  "description": "List all puzzle themes with their display names and descriptions. The keys returned here are the values accepted by the getRandom themes filter."
}