---
title: "Player games"
method: GET
path: "/player"
tags: ["Opening Explorer"]
---

# Player games

`GET /player`

**Endpoint: <https://explorer.lichess.org/player>**

Games of a Lichess player.

Responds with a stream of [newline delimited JSON](#description/streaming-with-nd-json). Will start indexing
on demand, immediately respond with the current results, and stream
more updates until indexing is complete. The stream is throttled
and deduplicated. Empty lines may be sent to avoid timeouts.

Will index new games at most once per minute, and revisit previously
ongoing games at most once every day.

Example: `curl https://explorer.lichess.org/player?player=revoof&color=white&play=d2d4,d7d5&recentGames=1`

## Query parameters

- `player` string, required
- `color` 'white' | 'black', required
- `variant` 'standard' | 'chess960' | 'crazyhouse' | 'antichess' | 'atomic' | 'horde' | 'kingOfTheHill' | 'racingKings' | 'threeCheck' | 'fromPosition'
- `fen` string
- `play` string
- `speeds` Speed[]
- `modes` string[]
- `since` string
- `until` string
- `moves` integer
- `recentGames` integer

## Response `200`

Opening statistics and game references for the position.

---

[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)