---
title: "Get puzzle race results"
method: GET
path: "/api/racer/{id}"
tags: ["Puzzles"]
---

# Get puzzle race results

`GET /api/racer/{id}`

Get the results of a [puzzle race](https://lichess.org/racer).
Returns information about players, puzzles, and the current status of the race.
- <https://lichess.org/racer>

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

## Path parameters

- `id` string, required

## Response `200`

The puzzle race results.

- PuzzleRaceResults
  - `id` string, required — Unique identifier of the puzzle race
  - `owner` string, required — Owner of the puzzle race
  - `players` object[], required — List of players participating in the race
    - `name` string, required — Player username
    - `score` integer, required — Player's current score in the race
    - `id` string — User ID. Missing if player is anonymous.
    - `flair` string — User's flair icon
    - `patron` boolean — Use patronColor value instead to determine if player is a patron.
    - `patronColor` integer — Players can choose a color for their Patron wings. See [here for the color mappings](https://github.com/lichess-org/lila/blob/master/ui/lib/css/abstract/_patron-colors.scss). The presence of this field indicates the player is an active Patron.
  - `puzzles` object[], required — List of puzzles in the race
    - `id` string, required — Puzzle ID
    - `fen` string, required — X-FEN position of the puzzle
    - `line` string, required — Solution moves sequence
    - `rating` integer, required — Puzzle Glicko2 rating
  - `finishesAt` integer, required — Timestamp in milliseconds when the race finishes
  - `startsAt` integer, required — Timestamp in milliseconds when the race started

## Other responses

- `404` — The puzzle race was not found, or is no longer available.

---

[API](https://skmtc.net/lichess/apis/lichess-org-api-reference.md) · [All operations](https://skmtc.net/lichess/apis/lichess-org-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lichess/lichess-org-api-reference/versions/1425db81eb3b/schema)