Kennzeichencheck abrufen

Verwenden Sie diesen Endpunkt, um einen gespeicherten Check vor dem Anlegen einer Reservierung erneut zu lesen. Erforderlich ist license_plates:read.

Beschreibung

Liefert Status und Ergebnis eines Kennzeichenchecks.

Parameter

check_idpathPflicht

Öffentliche Check-ID.

Beispiel: lpc_test_3c4d5e6f708192a3b4c5d6e7

Responses

200

Aktueller Check.

404

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

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 Check-ID.
`object`	string	Immer	Konstanter Wert `license_plate_check`.
`environment`	enum	Immer	`test` oder `live`.
`livemode`	boolean	Immer	`true` für Live-Ressourcen.
`status`	string	Immer	Aktuell `completed`.
`availability`	enum	Immer	`available`, `unavailable` oder `indeterminate`.
`plate`	object	Immer	Normalisierte Kennzeichenkombination mit Markierung, Fahrzeugtyp und Saison.
`reservable`	boolean	Immer	Gibt an, ob genau dieser Check reserviert werden kann.
`expires_at`	date-time	Immer	Ende des Gültigkeitsfensters.
`message`	string	Optional	Lesbare Ergebnismeldung.
`reason`	string	Optional	Maschinenlesbarer Grund für das Ergebnis.
`duration_ms`	integer	Optional	Dauer des Checks in Millisekunden.
`office`	object	Optional	Verwendeter Behördenkontext.
`candidates`	array	Optional	Einzelne reservierbare Checks aus einer Wildcard-Suche.
`created_at, updated_at`	date-time	Immer	Erstellungs- und Änderungszeitpunkt.

{
  "id": "lpc_test_3c4d5e6f708192a3b4c5d6e7",
  "object": "license_plate_check",
  "environment": "test",
  "livemode": false,
  "status": "completed",
  "availability": "available",
  "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
    }
  },
  "reservable": true,
  "expires_at": "2026-08-26T10:50:00+02:00",
  "message": "Das Wunschkennzeichen ist verfügbar.",
  "created_at": "2026-08-26T10:20:00+02:00",
  "updated_at": "2026-08-26T10:20:00+02:00"
}

Gültigkeitsfenster

Ein Check ist nur bis expires_at Grundlage für eine Reservierung. Danach ist die tatsächliche Verfügbarkeit erneut zu prüfen.

{ "id": "lpc_test_3c4d5e6f708192a3b4c5d6e7", "object": "license_plate_check", "environment": "test", "livemode": false, "status": "completed", "availability": "available", "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 } }, "reservable": true, "expires_at": "2026-08-26T10:50:00+02:00", "message": "Das Wunschkennzeichen ist verfügbar.", "created_at": "2026-08-26T10:20:00+02:00", "updated_at": "2026-08-26T10:20:00+02:00" }