Kennzeichen reservieren

Die Reservierung bindet Check, Halter und gewählte Fahrzeugkonfiguration. Ein Testschlüssel simuliert den Ablauf ohne Behördenportal. Erforderlich ist license_plates:write.

Beschreibung

Startet eine Reservierung aus einem verfügbaren Check und einem gespeicherten Halter.

Parameter

Idempotency-KeyheaderPflicht

Eindeutiger Schlüssel für diese Reservierung.

Beispiel: reserve-hb-ab-123-customer-1842

Request-Body

Der Body wird als application/json übertragen. Verwenden Sie ausschließlich die dokumentierten Feldnamen.

Request-Felder

Feld	Typ	Angabe	Beschreibung
`check_id`	string	Pflicht	ID eines noch gültigen, verfügbaren und reservierbaren Kennzeichenchecks.
`holder_id`	string	Pflicht	Halter-ID aus Ihrem Konto und derselben Umgebung.

{
  "check_id": "lpc_test_3c4d5e6f708192a3b4c5d6e7",
  "holder_id": "hld_test_1a2b3c4d5e6f708192a3b4c5"
}

SchemaquelleOpenAPI 3.1 herunterladen

Responses

202

Reservierungsauftrag angenommen; Status über die Ressourcen-ID verfolgen.

404

check_id oder holder_id ist unbekannt.

409

Die Kombination des Checks wird bereits von einem anderen Auftrag reserviert.

422

Check ist abgelaufen oder nicht reservierbar, oder Halterdaten und Nutzungsangaben passen nicht zusammen.

Response-Body

Content-Type: application/json. Die erfolgreiche Antwort enthält die nachfolgend beschriebenen Felder.

Response-Felder

Feld	Typ	Angabe	Beschreibung
`id`	string	Immer	Öffentliche Reservierungs-ID.
`object`	string	Immer	Konstanter Wert `license_plate_reservation`.
`environment`	enum	Immer	`test` oder `live`.
`livemode`	boolean	Immer	`true` für Live-Ressourcen.
`status`	enum	Immer	`processing`, `reserved`, `used`, `failed` oder `expired`.
`holder_id`	string	Immer	Verwendete Halter-ID.
`holder_revision`	integer	Immer	Im Antrag gespeicherte Version der Halterdaten.
`check_id`	string	Immer	Zugrunde liegender Kennzeichencheck.
`plate`	object	Immer	Reservierte Kennzeichenkombination.
`pin`	string\|null	Optional	Reservierungs-PIN nach erfolgreicher Reservierung.
`valid_until`	date-time\|null	Optional	Gültigkeitsende der Reservierung.
`reserved_at`	date-time\|null	Optional	Zeitpunkt der erfolgreichen Reservierung.
`confirmation_available`	boolean	Immer	Gibt an, ob die PDF-Bestätigung abgerufen werden kann.
`result`	object	Optional	Ergebnisdetails des Reservierungslaufs.
`failure`	object	Optional	Fehlercode und Meldung bei einem Fehlschlag.
`poll_after_seconds`	integer	Optional	Empfohlenes Intervall bis zum nächsten Abruf.
`accepted`	boolean	Optional	Nur in der direkten Antwort eines Schreibzugriffs.
`created_at, updated_at`	date-time	Immer	Erstellungs- und Änderungszeitpunkt.

{
  "id": "lpr_test_4d5e6f708192a3b4c5d6e7f8",
  "object": "license_plate_reservation",
  "environment": "test",
  "livemode": false,
  "status": "reserved",
  "holder_id": "hld_test_1a2b3c4d5e6f708192a3b4c5",
  "holder_revision": 1,
  "check_id": "lpc_test_3c4d5e6f708192a3b4c5d6e7",
  "plate": {
    "district": "HB",
    "letters": "AB",
    "number": "123",
    "formatted": "HB AB 123",
    "marker": "none",
    "vehicle_type": "car",
    "season": {
      "enabled": false,
      "start_month": null,
      "end_month": null
    }
  },
  "pin": "TEST1234",
  "valid_until": "2026-09-09T23:59:59+02:00",
  "reserved_at": "2026-08-26T10:22:00+02:00",
  "confirmation_available": true,
  "result": {
    "message": "Das Wunschkennzeichen wurde im Testmodus reserviert.",
    "officially_confirmed": true
  },
  "created_at": "2026-08-26T10:22:00+02:00",
  "updated_at": "2026-08-26T10:22:00+02:00",
  "accepted": true
}

Reservierungsstatus

202 Accepted bestätigt die Annahme des Requests. Die Reservierung ist erst bei status: reserved mit PIN und Gültigkeitsdatum abgeschlossen.

Reservierung verifiziert den Halter nicht

Die Reservierung akzeptiert verifizierte wie unverifizierte Halter und speichert deren Datenstand zum Zeitpunkt der Reservierung; der Verifizierungsstatus ändert sich dadurch nicht. Ob der Halter für den späteren Antrag verifiziert sein muss, hängt davon ab, ob Sie mit Vollmacht auf Digital-Zulassen oder mit eigenem KBA-Großkundenzugang einreichen. Für AB gilt keine Verifizierungspflicht.

Testsimulation

{ "id": "lpr_test_4d5e6f708192a3b4c5d6e7f8", "object": "license_plate_reservation", "environment": "test", "livemode": false, "status": "reserved", "holder_id": "hld_test_1a2b3c4d5e6f708192a3b4c5", "holder_revision": 1, "check_id": "lpc_test_3c4d5e6f708192a3b4c5d6e7", "plate": { "district": "HB", "letters": "AB", "number": "123", "formatted": "HB AB 123", "marker": "none", "vehicle_type": "car", "season": { "enabled": false, "start_month": null, "end_month": null } }, "pin": "TEST1234", "valid_until": "2026-09-09T23:59:59+02:00", "reserved_at": "2026-08-26T10:22:00+02:00", "confirmation_available": true, "result": { "message": "Das Wunschkennzeichen wurde im Testmodus reserviert.", "officially_confirmed": true }, "created_at": "2026-08-26T10:22:00+02:00", "updated_at": "2026-08-26T10:22:00+02:00", "accepted": true }