---
title: "Export games of a bulk pairing"
method: GET
path: "/api/bulk-pairing/{id}/games"
tags: ["Bulk pairings"]
---

# Export games of a bulk pairing

`GET /api/bulk-pairing/{id}/games`

Download games of a bulk in PGN or [ndjson](#description/streaming-with-nd-json) format, depending on the request `Accept` header.

## Path parameters

- `id` string, required — The ID of the bulk pairing

## Query parameters

- `moves` boolean
- `pgnInJson` boolean
- `tags` boolean
- `clocks` boolean
- `evals` boolean
- `accuracy` boolean
- `opening` boolean
- `division` boolean
- `literate` boolean

## Headers

- `Accept` 'application/x-chess-pgn' | 'application/x-ndjson'

## Response `200`

The representation of the games.

## Changes

- **2026-09-02** `9b0422af5084` — 8 breaking, 12 warning
  - added `#/components/schemas/GamePlayerUser, #/components/schemas/GamePlayerAi` to the `players/black` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/GamePlayerUser, #/components/schemas/GamePlayerAi` to the `players/white` response property `oneOf` list for the response status `200`
  - the `players/black` response's property type changed from `object` to no type for status `200`
  - the `players/white` response's property type changed from `object` to no type for status `200`
  - …16 more

[Change history](https://skmtc.dev/lichess/apis/lichess-org-api-reference/changes/api/bulk-pairing/:id/games/get.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/9b0422af5084/schema)