# Lichess Board API

**Canonical:** https://apis.io/apis/lichess/lichess-board-api/  
**Provider:** Lichess — https://apis.io/providers/lichess/  
**Base URL:** https://lichess.org  
**Documentation:** https://lichess.org/api

Lichess Board API is one of 23 APIs that [Lichess](https://apis.io/providers/lichess/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification. This API exposes 2 JSON Schema definitions. Tagged areas include Boards. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, a JSON-LD context, and 2 JSON Schemas.

Play on Lichess with physical boards and third-party clients. Works with normal Lichess accounts. Engine play or assistance is [forbidden](https://lichess.org/page/fair-play). ### Features - [Stream incoming chess moves](#tag/board/GET/api/board/game/stream/{gameId}) - [Play chess moves](#tag/board/POST/api/board/game/{gameId}/move/{move}) - [Read](#tag/board/GET/api/board/game/stream/{gameId}) and [write](#tag/board/POST/api/board/game/{gameId}/chat) in the player and spectator chats - [Receive](#tag/board/GET/api/stream/event), [create](#tag/challenges/POST/api/challenge/{username}) and [accept](#tag/challenges/POST/api/challenge/{challengeId}/accept) (or [decline](#tag/challenges/POST/api/challenge/{challengeId}/decline)) challenges - [Abort](#tag/board/POST/api/board/game/{gameId}/abort) and [resign](#tag/board/POST/api/board/game/{gameId}/resign) games - Compatible with normal Lichess accounts ### Restrictions - Engine assistance, or any kind of outside help, is [forbidden](https://lichess.org/page/fair-play) - Time controls: [Rapid, Classical and Correspondence](https://lichess.org/faq#time-controls) only. For direct challenges, games vs AI, and bulk pairing, Blitz is also possible. ### Links - [Announcement](https://lichess.org/blog/XlRW5REAAB8AUJJ-/welcome-lichess-boards) - [Implementation example](https://github.com/lichess-org/api-demo) and [live demo](https://lichess-org.github.io/api-demo/) - [Certabo support](https://github.com/haklein/certabo-lichess) - [Lichs (play from command-line)](https://github.com/Cqsi/lichs) - [Lichess discord bot](https://top.gg/bot/707287095911120968) - [cli-chess](https://github.com/trevorbayless/cli-chess/) - [Blunderly 3D board](https://github.com/maurimo/blunderly) - Yours? Please make [an issue or pull request](https://github.com/lichess-org/api).

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/lichess/refs/heads/main/openapi/lichess-board-api-openapi.yml
- **Documentation** — https://lichess.org/api
- **AsyncAPI** — https://raw.githubusercontent.com/api-evangelist/lichess/refs/heads/main/asyncapi/lichess-asyncapi.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/lichess/refs/heads/main/json-schema/lichess-game-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/lichess/refs/heads/main/json-schema/lichess-user-schema.json
- **JSONLD** — https://raw.githubusercontent.com/api-evangelist/lichess/refs/heads/main/json-ld/lichess-context.jsonld
- **SpectralRuleset** — https://raw.githubusercontent.com/api-evangelist/lichess/refs/heads/main/rules/lichess-rules.yml

## Other Lichess APIs (12)

- [Lichess Account API](https://apis.io/apis/lichess/lichess-account-api/)
- [Lichess Analysis API](https://apis.io/apis/lichess/lichess-analysis-api/)
- [Lichess Bot API](https://apis.io/apis/lichess/lichess-bot-api/)
- [Lichess Broadcasts API](https://apis.io/apis/lichess/lichess-broadcasts-api/)
- [Lichess Bulk pairings API](https://apis.io/apis/lichess/lichess-bulk-pairings-api/)
- [Lichess Challenges API](https://apis.io/apis/lichess/lichess-challenges-api/)
- [Lichess External engine API](https://apis.io/apis/lichess/lichess-external-engine-api/)
- [Lichess FIDE API](https://apis.io/apis/lichess/lichess-fide-api/)
- [Lichess Games API](https://apis.io/apis/lichess/lichess-games-api/)
- [Lichess Messaging API](https://apis.io/apis/lichess/lichess-messaging-api/)
- [Lichess OAuth API](https://apis.io/apis/lichess/lichess-oauth-api/)
- [Lichess Opening Explorer API](https://apis.io/apis/lichess/lichess-opening-explorer-api/)

## Tags

Boards

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/lichess/lichess-board-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/lichess/.