# Prüfbericht einer E-Rechnung lesen (https://developer.bimetrics.de/reference/documents/get-document-einvoice-validation-report)

`GET https://app.bimetrics.de/api/document/{id}/einvoice-validation-report`

operationId: `getDocumentEinvoiceValidationReport` · Berechtigung (Scope): `read` · Bereich: Belege

Liefert das Ergebnis der Prüfung einer eingehenden E-Rechnung mit den Meldungen ihres Prüfberichts: Stufe, Regel, Text und Fundstelle. bimetrics prüft dabei nicht neu, die Meldungen stammen aus dem Bericht, der beim Empfang entstand. Texte und Fundstellen können Rechnungsdaten zitieren. Hat der Beleg keine Prüfung, antwortet die Route mit `404`, etwa bei einem Scan oder einer E-Rechnung, die vor dem 27.09.2026 einging. Bei `unchecked` gibt es keinen Bericht: Die Meldungen fehlen, und `format=xml` antwortet mit `404`.

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 Belegs (UUID). |
| `format` | query | nein | string: `xml` | `xml` liefert statt der Meldungen den Prüfbericht als Datei `pruefbericht.xml`, so wie das Prüfprogramm ihn schrieb. |

### Beispiel

```sh
curl --fail-with-body "https://app.bimetrics.de/api/document/{id}/einvoice-validation-report" \
  -H "Authorization: Bearer $BIMETRICS_API_KEY"
```

### Antworten

| Status | Beschreibung | Inhalt |
| --- | --- | --- |
| 200 | Erfolg. Mit `format=xml` die Datei `pruefbericht.xml`. | `application/json`: EinvoiceValidationReport, `application/xml`: string (binary) |
| 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 diesen Endpunkt (`APIKeyPermissionDenied`, `context.scope` nennt sie; Berechtigungen sind fest: neuen Schlüssel anlegen, austauschen, alten widerrufen), der Endpunkt ist für API-Schlüssel nicht freigegeben (`APIKeyPermissionDenied` ohne `context.scope`), 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 (`EinvoiceValidationReport`)

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `checkedAt` | string (date-time) | Zeitpunkt der Prüfung. |
| `engine` | string | Prüfprogramm mit Version, etwa `mustang-2.26.0`; nur `mustang`, wenn es nicht lief. |
| `errorCount` | integer | Anzahl der Fehler im Prüfbericht. |
| `messages` | Array<EinvoiceValidationMessage> | Meldungen des Prüfberichts, Fehler zuerst, dann Warnungen und Anmerkungen, je in der Reihenfolge des Berichts; höchstens 500. Fehlt bei `unchecked`. |
| `status` | string: `valid`, `warnings`, `invalid`, `unchecked` | Stufe: `valid` (gültig), `warnings` (gültig mit Hinweisen), `invalid` (ungültig) oder `unchecked` (nicht geprüft, das Prüfprogramm lief nicht). |
| `warningCount` | integer | Anzahl der Hinweise (Warnungen) im Prüfbericht. |

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