Dokumentation

Entwicklerdokumentation · API v1

Fahrzeug­zulassung API
für Deutschland

Abmelden, zulassen, umschreiben – direkt aus Ihrer eigenen Software. Diese Dokumentation führt Sie Schritt für Schritt durch die Integration: vom ersten Testantrag bis zum Livebetrieb.

Erste Schritte

In drei Schritten zur Integration

  1. 01Testschlüssel erstellenIm Dashboard einen API-Schlüssel mit dz_test_-Präfix anlegen.
  2. 02Ersten Testantrag sendenDer Schnellstart führt durch den ersten Antrag. Dabei wird nichts an das KBA übermittelt.
  3. 03Produktiv gehenProduktivschlüssel eintragen – die Anfragen bleiben identisch, nur die Umgebung wechselt.

Überblick

Die Dokumentation im Überblick

Schnellstart

Der geführte Weg zum ersten Testantrag.

Schnellstart öffnen

Grundlagen

Wie die API funktioniert: Authentifizierung, Testmodus, Statusmodell und Fehlerbehandlung.

Grundlagen lesen

Geschäftsvorfälle

Von der Abmeldung bis zur Neuzulassung: welche Daten jeder Vorgang braucht.

Vorgänge ansehen

Wunschkennzeichen

Kennzeichen prüfen und reservieren, bevor der Antrag gestellt wird.

Details ansehen

Anwendungsfälle

Integrationsbeispiele für Autohäuser, Fuhrparks und Plattformen.

Beispiele ansehen

API-Referenz

Alle Endpunkte im Detail, mit Beispielen für Anfrage und Antwort.

Referenz öffnen

Testumgebung

Testschlüssel führen alle Anfragen gegen die Testumgebung aus. KBA, Behördenportale und Zahlungsdienste werden dabei nicht aufgerufen.

Testmodus im Detail

Häufige Fragen

Häufige Fragen zur Integration

Was ist die Digital-Zulassen Fahrzeugzulassung API?

Eine REST API, über die Sie Fahrzeuge direkt aus Ihrer eigenen Software abmelden, zulassen oder umschreiben. Auch Wunschkennzeichen, Dokumente und Gebühren lassen sich darüber abwickeln.

Welche Zulassungsvorgänge unterstützt die API?

Abmeldung, Wiederzulassung, Neuzulassung, Tageszulassung, Umschreibung und die Adressänderung des Halters. Welche Daten jeder Vorgang braucht, steht im Bereich Geschäftsvorfälle.

Ist die API eine i-Kfz API?

Ja. Die API bildet die digitalen i-Kfz-Zulassungsvorgänge in Deutschland ab – von der Abmeldung bis zur Neuzulassung. Die Übermittlung an KBA und Zulassungsbehörde übernimmt Digital-Zulassen; Integrationen verwenden ausschließlich die dokumentierten Routen unter /api/v1/.

Kann ich eine Kfz-Zulassung testen, ohne sie an das KBA zu senden?

Ja. Mit einem Testschlüssel bleiben alle Daten in der Testumgebung. KBA, Behördenportale sowie QES-, Zahlungs-, Produktions- und Versanddienste werden dabei nicht aufgerufen.

Wo erstelle ich einen API-Schlüssel?

In der Schlüsselverwaltung des Digital-Zulassen Dashboards. Dort werden Schlüssel erstellt, rotiert und widerrufen – die öffentliche Dokumentation enthält keine Schlüssel oder Accountdaten.

Wie erhält die antragstellende Person den Signaturlink?

Wenn eine Signatur erforderlich ist, liefert die API die URL im Feld next_action. Ihre Anwendung übergibt den Link an die signierende Person.

Integration starten

Testschlüssel erstellen und ersten Antrag senden

Schnellstart öffnen API-Schlüssel verwalten

Zum Öffnen eines Treffers Enter drücken.