v3

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

Games

Import one game

Import a game from PGN. See https://lichess.org/paste. Rate limiting: 200 games per hour for OAuth requests, 100 games per hour for anonymous requests. To broadcast ongoing games, consider pushing to a broadcast instead. To analyse a position or a line, just construct an analysis board URL (most standard tags supported if URL-encoded): https://lichess.org/analysis/pgn/e4_e5_Nf3_Nc6_Bc4_Bc5_Bxf7+

post/api/import

Response

The game was successfully imported.

idstring

The game ID

urlstring uri

The game URL

Example response

{
  "id": "R6iLjwz5",
  "url": "https://lichess.org/R6iLjwz5"
}