---
title: "Prüft eine XRechnung (UBL oder CII) oder eine ZUGFeRD-PDF gegen EN 16931 – derselbe Prüfer, durch den jede von uns erzeugte Datei läuft"
method: POST
path: "/api/v1/pruefen"
---

# Prüft eine XRechnung (UBL oder CII) oder eine ZUGFeRD-PDF gegen EN 16931 – derselbe Prüfer, durch den jede von uns erzeugte Datei läuft

`POST /api/v1/pruefen`

## Request

- Base URL: `https://rechnungslotse.de`
- URL: `https://rechnungslotse.de/api/v1/pruefen`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://rechnungslotse.de/authorize`, token URL `https://rechnungslotse.de/api/oauth/token`, scopes: `pruefen`)

Prüft eine XRechnung (UBL oder CII) oder eine ZUGFeRD-PDF gegen EN 16931 – derselbe Prüfer, durch den jede von uns erzeugte Datei läuft. Entweder `multipart/form-data` mit Feld `file` oder der rohe Dateiinhalt mit `Content-Type: application/xml` bzw. `application/pdf`, höchstens 5 MB. Der Dateityp wird aus den Bytes bestimmt, nicht aus dem Namen. Kein Kontingentverbrauch, nur die Ratengrenze je Schlüssel.

## Headers

- `Idempotency-Key` string

## Response `201`

200 mit `valid`, `profile`, `format` (ubl, cii, pdf), `summary` (errors, warnings, notices) und `messages` je Regel mit `severity`, `code`, `location` und `text`. Eine Datei, die durchfällt, ist KEIN Fehler: 200 mit `valid: false`. 400 nur, wenn die Datei weder XML noch PDF ist, 413 über 5 MB, 503 wenn der Prüfdienst nicht antwortet.

- object

## Other responses

- `400`: Eingabe unbrauchbar: invalid_input
- `401`: Kein oder ungültiger Zugangsschlüssel: api_schluessel_ungueltig, api_schluessel_abgelaufen
- `403`: Recht „pruefen“ fehlt am Schlüssel.
- `429`: Ratengrenze oder Kontingent: quota_exhausted, rate_limited. Retry-After sagt, wann.
- `503`: Prüfdienst nicht erreichbar – später wiederholen.

---

[API](https://skmtc.dev/rechnungslotse/apis/rechnungslotse-schnittstelle-v1.md) · [All operations](https://skmtc.dev/rechnungslotse/apis/rechnungslotse-schnittstelle-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/rechnungslotse/apis/rechnungslotse-schnittstelle-v1/revisions/0997b13254c2?raw)