Kennzeichenreservierungen auflisten

Die cursorbasierte Liste bleibt auf Ihr Konto und die Schlüsselumgebung begrenzt. Erforderlich ist license_plates:read.

Beschreibung

Listet Ihre Reservierungen in der Schlüsselumgebung.

Parameter

limitquery

Seitengröße zwischen 1 und 25.

Beispiel: 20

starting_afterquery

Cursor aus next_cursor.

Beispiel: lpr_test_4d5e6f708192a3b4c5d6e7f8

Responses

200

Eine Seite von Reservierungen.

400

Cursor oder Filter ist ungültig.

Response-Body

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

Response-Felder

Feld	Typ	Angabe	Beschreibung
`object`	string	Immer	Konstanter Wert `list`.
`data`	array	Immer	Reservierungsobjekte dieser Seite. Jedes Element entspricht dem Reservierungsschema.
`has_more`	boolean	Immer	Gibt an, ob eine weitere Seite vorhanden ist.
`next_cursor`	string\|null	Immer	Cursor für `starting_after`; `null` am Listenende.

{
  "object": "list",
  "data": [
    {
      "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"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Statusabgleich

Verwenden Sie die Reservierungs-ID für Folgerequests. Den aktuellen Status liefert der Endpunkt für die einzelne Reservierung.

{ "object": "list", "data": [ { "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" } ], "has_more": false, "next_cursor": null }