Zulassungsstellen ermitteln

Eine Postleitzahl kann mehrere Orte besitzen. Die Antwort nennt in diesem Fall location_options; übergeben Sie location_id oder city anschließend direkt im Kennzeichencheck. Erforderlich ist license_plates:read.

Beschreibung

Ermittelt die für eine Postleitzahl und optional einen Ort passenden Zulassungsstellen.

Parameter

postal_codequeryPflicht

Fünfstellige deutsche Postleitzahl.

Beispiel: 28195

location_idquery

Optionale positive Orts-ID aus location_options.

Beispiel: 42

cityquery

Optionaler Ort zur eindeutigen Auswahl.

Beispiel: Bremen

Responses

200

Passende Behörden- und Kennzeichenkontexte.

422

Postleitzahl oder Ort 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 `license_plate_office_lookup`.
`postal_code`	string	Immer	Geprüfte Postleitzahl.
`selection_required`	boolean	Immer	Gibt an, ob der Ort noch eindeutig ausgewählt werden muss.
`selected_location_id`	integer\|null	Optional	Eindeutig ausgewählte Orts-ID.
`location_options`	array	Immer	Mögliche Orte bei einer mehrdeutigen Postleitzahl.
`zulassungsstelle`	object	Optional	Ermittelte Zulassungsstelle.
`districts`	array	Optional	Zulässige Unterscheidungszeichen und verfügbare Modi.

{
  "object": "license_plate_office_lookup",
  "postal_code": "28195",
  "selection_required": false,
  "selected_location_id": 42,
  "location_options": [],
  "zulassungsstelle": {
    "id": 17,
    "name": "BürgerServiceCenter-Stresemannstraße"
  },
  "districts": [
    {
      "district": "HB",
      "modes": {
        "normal": {
          "online": true
        }
      }
    }
  ]
}

Mehrdeutige Orte

Bei selection_required: true muss die anfragende Anwendung location_id oder city übergeben. Der erste Treffer darf nicht automatisch verwendet werden.

{ "object": "license_plate_office_lookup", "postal_code": "28195", "selection_required": false, "selected_location_id": 42, "location_options": [], "zulassungsstelle": { "id": 17, "name": "BürgerServiceCenter-Stresemannstraße" }, "districts": [ { "district": "HB", "modes": { "normal": { "online": true } } } ] }