v3

OpenAPI 3.1.0AGPL-3.0-or-later2026-07-311871891.1 MB
Puzzles

Get puzzle race results

Get the results of a puzzle race. Returns information about players, puzzles, and the current status of the race.

Note that Lichess puzzle races are not persisted, and are only available for 30 minutes. After that delay, they are permanently deleted.

get/api/racer/{id}

Path parameters

idstring required

The puzzle race ID

Response

The puzzle race results.

idstring required

Unique identifier of the puzzle race

ownerstring required

Owner of the puzzle race

finishesAtinteger required

Timestamp in milliseconds when the race finishes

startsAtinteger required

Timestamp in milliseconds when the race started