# Mahnungsentwurf prüfen oder Original ansehen (https://developer.bimetrics.de/reference/receivables/preview-reminder)

`POST https://app.bimetrics.de/api/reminder/{id}/preview`

operationId: `previewReminder` · Berechtigung (Scope): `sales:read` · Bereich: Forderungen und Mahnungen

Prüft expectedUpdatedAt und liefert PDF-Bytes sowie daraus gerenderte Bildseiten. Bei Entwürfen bindet previewToken die Vorschau an Entwurfsversion, aktuellen Zahlungsstand und Druckstand. Bei ausgestellten oder zurückgezogenen Mahnungen stammen PDF und Forderungssnapshot ausschließlich aus dem gespeicherten Original; previewToken ist leer. Keine Änderung, Buchung oder Nachricht.

Benötigt einen Schlüssel mit der Berechtigung `sales:read` oder `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 Objekts dieser Firma (UUID); bei Forderungsständen und neuen Korrekturen die Quellentwurfs-ID. |

### Request-Body (`application/json`)

 

Schema `ReminderVersion`.

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `expectedUpdatedAt` | string (date-time), kann null sein | Exakter zuletzt gelesener updatedAt-Wert einschließlich Sekundenbruchteilen. |

### Beispiel

```sh
curl --fail-with-body "https://app.bimetrics.de/api/reminder/{id}/preview" \
  -H "Authorization: Bearer $BIMETRICS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"and","children":[],"limit":50,"offset":0}'
```

### Antworten

| Status | Beschreibung | Inhalt |
| --- | --- | --- |
| 200 | Erfolg. | `application/json`: ReminderPreview |
| 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 aktiven Tarif mit API-Zugang, etwa in der Testphase oder nach Ende 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 (`ReminderPreview`)

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `pages` | Array<PDFPreviewPage>, kann null sein | Geordnete Bildseiten aus genau den zurückgegebenen PDF-Bytes; benötigen keinen eingebetteten PDF-Viewer. |
| `pdf` | PreviewFile | Vollständige PDF-Datei als Base64: Entwurfsvorschau oder gespeichertes unverändertes Original. |
| `previewToken` | string | Bei Entwürfen Token für die anschließende unveränderte Ausstellung; bei ausgestellten oder zurückgezogenen Mahnungen leer. |
| `receivable` | InvoiceReceivable | Bei Entwürfen aktuell geprüfter Forderungsstand; bei ausgestellten oder zurückgezogenen Mahnungen der bei Ausstellung eingefrorene Snapshot. |
| `reminder` | PaymentReminder | Geprüfte Mahnung samt aktuellem Status. |

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