# Lichess

**Canonical:** https://apis.io/providers/lichess/  
**Website:** https://lichess.org  
**APIs profiled:** 23

Lichess is a free, ad-free, open-source online chess server operated by a French nonprofit and powered entirely by volunteers and donations. It serves millions of games per day with live play, tournaments, puzzles, studies, broadcasts, analysis, and a public API. The server (lila), engine library (scalachess), mobile app, board UI (chessground), and distributed Stockfish analysis network (fishnet) are all open source under AGPL-3.0, MIT, and GPL-3.0 licenses. The Lichess API provides 185 documented operations across 23 functional areas including Account, Users, Games, Puzzles, Teams, Board, Bot, Challenges, Arena and Swiss Tournaments, Simuls, Studies, Broadcasts, Messaging, OAuth, FIDE, Opening Explorer, Tablebase, External Engine, and Cloud Analysis, with comprehensive ND-JSON streaming support.

## Kin Score — 58.0 / 100 (strong)

Scored 2026-08-20 under rubric 0.12.0. Trend: flat (+0.0 from 58.0).

| Facet | Score |
|---|---|
| Discoverability | 74.1 |
| Contract Quality | 81.5 |
| Governance | 13.6 |
| Contract Governance | 13.6 |
| Operational Transparency | 52.6 |
| Developer Ergonomics | 66.7 |
| Commercial Clarity | 42.1 |
| Access Clarity | 42.1 |

## Agent readiness — 45.2 (agent-ready)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | derived |
| Reversibility Documented | documented |
| MCP Server | no |
| Auth Clarity | yes |
| Idempotency | no |
| Error Semantics | verified |
| OpenAPI Examples | verified |
| Rate Limit Signal | documented |
| Event Surface Described | derived |
| Agent Skills | no |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | no |

## Access

Freemium · Self-serve signup — onboarding: self-serve, pricing: freemium, trial: no (confidence: high).

## APIs (23)

- **Lichess Account API** — Read and write account information and preferences. <https://lichess.org/account/preferences/game-display>
- **Lichess Analysis API** — Access Lichess cloud evaluations database. <https://lichess.org/analysis>
- **Lichess Board API** — 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). #...
- **Lichess Bot API** — Play on Lichess as a bot. Allows engine play. Read the [blog post announcement of lichess bots](https://lichess.org/blog/WvDNticAAMu_mHKP/welcome-lichess-bots). Only works with ...
- **Lichess Broadcasts API** — Relay chess events on Lichess. [Official broadcasts](https://lichess.org/broadcast) are maintained by Lichess, but you can [create your own broadcasts](https://lichess.org/broad...
- **Lichess Bulk pairings API** — Create many games for other players. These endpoints are intended for tournament organisers.
- **Lichess Challenges API** — Send and receive challenges to play. To create a lot of challenges, consider [bulk pairing](#tag/bulk-pairings/POST/api/bulk-pairing) instead.
- **Lichess External engine API** — **This API is in alpha and subject to change.** Use or provide external engine analysis. External engines can provide analysis on pages like the [analysis board](https://lichess...
- **Lichess FIDE API** — FIDE players and federations from [their public download](https://ratings.fide.com/download_lists.phtml). <https://lichess.org/fide>
- **Lichess Games API** — Access games played on Lichess. <https://lichess.org/games>
- **Lichess Messaging API** — Private messages with other players. <https://lichess.org/inbox>
- **Lichess OAuth API** — Obtaining and revoking OAuth tokens. [Read about the Lichess API authentication methods and code examples](https://github.com/lichess-org/api/blob/master/example/README.md).
- **Lichess Opening Explorer API** — Lookup positions from the [Lichess opening explorer](https://lichess.org/analysis#explorer). Runs <https://github.com/lichess-org/lila-openingexplorer>. > [!important] > The hos...
- **Lichess Puzzles API** — Fetch and solve [puzzles](https://lichess.org/training), view your puzzle history and dashboard. Our collection of puzzles is in the public domain, you can [download it here](ht...
- **Lichess Relations API** — Access relations between users.
- **Lichess Simuls API** — Access simuls played on Lichess. <https://lichess.org/simul>
- **Lichess Studies API** — Access Lichess studies. <https://lichess.org/study>
- **Lichess Tablebase API** — Lookup positions from the [Lichess tablebase server](https://lichess.org/blog/W3WeMyQAACQAdfAL/7-piece-syzygy-tablebases-are-complete). > [!important] > The hostname for these e...
- **Lichess Teams API** — Access and manage Lichess teams and their members. <https://lichess.org/team>
- **Lichess Tournaments (Arena) API** — Access Arena tournaments played on Lichess. [Official Arena tournaments](https://lichess.org/tournament) are maintained by Lichess, but you can [create your own Arena tournament...
- **Lichess Tournaments (Swiss) API** — Access Swiss tournaments played on Lichess. [Read more about Swiss tournaments.](https://lichess.org/swiss).
- **Lichess TV API** — Access Lichess TV channels and games. <https://lichess.org/tv> & <https://lichess.org/games>
- **Lichess Users API** — Access registered users on Lichess. <https://lichess.org/player> - Each user blog exposes an atom (RSS) feed, like <https://lichess.org/@/thibault/blog.atom> - User blogs mashup...

## Agentic access (1)

- **Lichess Agentic Access** — 185 operations · 84 acting · 4 human-in-the-loop

## Security (3)

- **Lichess Authentication** — oauth2 · 1 scheme
- **Lichess Domain Security** — TLSv1.3 · HSTS · DNSSEC · DMARC
- **Lichess Vulnerability Disclosure** — security.txt · contact published

## Plans (1)

- **Lichess Plans Pricing**

## Tags

Chess, Games, Open-Source, Non-Profit, Tournaments, Puzzles, Bots, Streaming, ND-JSON, Authentication

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/lichess/). Scores are computed from the provider's own public artifacts under a published rubric.
