Kennzeichenreservierung abrufen

Verwenden Sie diesen Endpunkt für das Polling einer Reservierung. Erforderlich ist license_plates:read.

Beschreibung

Liefert Status, PIN, Gültigkeit und Bestätigungsverfügbarkeit.

Parameter

reservation_idpathPflicht

Öffentliche Reservierungs-ID.

Beispiel: lpr_test_4d5e6f708192a3b4c5d6e7f8

Responses

200

Aktuelle Reservierungsressource.

404

Reservierung fehlt oder gehört zu einer anderen Umgebung beziehungsweise einem anderen Mandanten.

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": "928174",
  "valid_until": "2026-11-26T23:59:59+01: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"
}

Terminale Zustände

failed, expired und used sind Endzustände. reserved kann einem Antrag zugeordnet werden; danach wechselt der Status zu used.

{ "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": "928174", "valid_until": "2026-11-26T23:59:59+01: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" }