Puzzles
Get a new puzzle
Get a random Lichess puzzle in JSON format.
If authenticated, only returns puzzles that the user has never seen before.
DO NOT use this endpoint to enumerate puzzles for mass download. Instead, download the full public puzzle database.
get/api/puzzle/next
Query parameters
anglestring
The theme or opening to filter puzzles with.
Available themes are listed in the lichess source code and the lichess training themes hyperlinks.
difficulty'easiest' | 'easier' | 'normal' | 'harder' | 'hardest'
The desired puzzle difficulty, relative to the authenticated user puzzle rating, or 1500 if anonymous.
color'white' | 'black'
The color to play. Better left empty to automatically get 50% white.
Response
The requested puzzle.