# Monat eines Kassenbuchs als Seitenbilder (https://developer.bimetrics.de/reference/cash-book/get-cash-book-pdfpages)

`GET https://app.bimetrics.de/api/cash-books/{id}/pdf/pages`

operationId: `getCashBookPDFPages` · Berechtigung (Scope): `read` · Bereich: Kassenbuch

Liefert dasselbe PDF wie `GET /api/cash-books/{id}/pdf` als Base64 (`pdf`) und seine Seiten als PNG-Bilder (`pages`), höchstens die ersten 20. So lässt sich ein Monat lesen, bevor man ihn abschließt, ohne PDF-Anzeige. Bei einem abgeschlossenen Monat steht im PDF die Zählung, auf die sich der Abschluss stützt, als „Zählung zum Abschluss“. Ein Monat vor dem Beginn des Kassenbuchs oder nach dem laufenden Monat ergibt `400 CashBookRejected` mit Feld `month`. Abrufen dürfen es alle Rollen.

Benötigt einen Schlüssel mit der Berechtigung `read`.

### Authentifizierung

`Authorization: Bearer bm_…` (alternativ `X-API-KEY: bm_…`, nie beide zugleich).

### Parameter

| Name | Ort | Pflicht | Typ | Beschreibung |
| --- | --- | --- | --- | --- |
| `id` | path | ja | string (uuid) | ID des Kassenbuchs (UUID). |
| `month` | query | ja | string | Monat als `JJJJ-MM`, etwa `2026-10`. |

### Beispiel

```sh
curl --fail-with-body "https://app.bimetrics.de/api/cash-books/{id}/pdf/pages" \
  -H "Authorization: Bearer $BIMETRICS_API_KEY"
```

### Antworten

| Status | Beschreibung | Inhalt |
| --- | --- | --- |
| 200 | Erfolg. | `application/json`: CashBookPDFPages |
| 400 | Ungültige Anfrage, z. B. ein Parameter mit ungültigem Wert wie eine ID, die keine UUID ist; korrigieren statt wiederholen. Mehr unter [Fehler](https://developer.bimetrics.de/errors). | `application/json`: Error |
| 401 | Kein gültiger Schlüssel: fehlt (`Unauthorized`), ist unbekannt, abgelaufen oder widerrufen oder wurde nicht in genau einem Header gesendet (`InvalidAPIKey`). Schlüssel prüfen, nicht wiederholen. Auch eine ID, die zu einer anderen Firma gehört, ergibt `401 Unauthorized`. | `application/json`: Error |
| 403 | Dem Schlüssel fehlt die Berechtigung für diese Route (`APIKeyPermissionDenied`), oder die Firma hat keinen API-Zugang (mehr), etwa nach Ende der Testphase oder des Abos (`APIUnavailable`). | `application/json`: Error |
| 404 | Nicht gefunden (`NotFound`). | `application/json`: Error |
| 413 | Die Anfrage ist zu groß (`APIRequestTooLarge`), siehe `x-bimetrics-limits`. | `application/json`: Error |
| 429 | Zu viele Anfragen; nach `Retry-After` Sekunden erneut senden. Mehr unter [Fehler](https://developer.bimetrics.de/errors). (Header: Retry-After) | `application/json`: Error |
| 500 | Serverfehler; die Anfrage später wiederholen. Mehr unter [Fehler](https://developer.bimetrics.de/errors). | `application/json`: Error |

#### Felder der Antwort 200 (`CashBookPDFPages`)

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `pages` | Array<PDFPreviewPage>, kann null sein | Die Seiten des PDF als PNG-Bilder in ihrer Reihenfolge, höchstens die ersten 20. |
| `pdf` | CashBookPDFFile | Das PDF wie `GET /api/cash-books/{id}/pdf`. |

Verschachtelte Schemas stehen vollständig in der OpenAPI-Beschreibung: https://app.bimetrics.de/api/openapi.json
