---
title: "Import PGN into a study"
method: POST
path: "/api/study/{studyId}/import-pgn"
tags: ["Studies"]
---

# Import PGN into a study

`POST /api/study/{studyId}/import-pgn`

Imports arbitrary PGN into an existing [study](https://lichess.org/study). Creates a new chapter in the study.
If the PGN contains multiple games (separated by 2 or more newlines)
then multiple chapters will be created within the study.
Note that a study can contain at most 64 chapters.

## Path parameters

- `studyId` string, required

## Response `200`

The chapters that were created.

- StudyImportPgnChapters
  - `chapters` object[]
    - `id` string — The chapter ID
    - `name` string — The chapter name
    - `players` object[]
      - `name` string, nullable — The player name
      - `rating` integer — The player rating
    - `status` string — The chapter status

## Other responses

- `400` — The creation of the chapter(s) failed.

## Changes

> 8 revisions in range; 3 could not be searched.

- **2026-07-31** `2b95ba6634c3` — 1 info
  - the `orientation` request property default value `white` was removed

[Change history](https://skmtc.dev/lichess/apis/lichess-org-api-reference/changes/api/study/:studyId/import-pgn/post.md)

---

[API](https://skmtc.dev/lichess/apis/lichess-org-api-reference.md) · [All operations](https://skmtc.dev/lichess/apis/lichess-org-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lichess/lichess-org-api-reference/revisions/c5ccdaeee7c4/schema)