---
title: "Import one game"
method: POST
path: "/api/import"
tags: ["Games"]
---

# Import one game

`POST /api/import`

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](#tag/broadcasts/POST/api/broadcast/round/{broadcastRoundId}/push).
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+](https://lichess.org/analysis/pgn/e4_e5_Nf3_Nc6_Bc4_Bc5_Bxf7+)

## Response `200`

The game was successfully imported.

- object
  - `id` string — The game ID
  - `url` string, uri — The game URL

---

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