API-Referenz

POST/api/v1/applications

Produktiven Antrag anlegen

Dieser Aufruf erzeugt einen echten Vorgang. Bei signaturpflichtigen Verfahren folgt die Signatur der antragstellenden Person beziehungsweise des Vertretungsberechtigten; AB wird ohne Signatur direkt weiterverarbeitet.

Beschreibung

Speichert einen produktiven Antrag und liefert den nächsten erforderlichen Schritt.

Parameter

Idempotency-KeyheaderPflicht

Eindeutiger Schlüssel für diese Antragserstellung. Bei Retries unverändert wiederverwenden.

Beispiel: req_019c84f5-7061-7a33-9628-8a32f0ec8cb1

Request-Body

Der Body wird als application/json übertragen. Verwenden Sie ausschließlich die dokumentierten Feldnamen.

Request-Schema

Request-Felder

Der Vorgangscode bestimmt Pflichtfelder, Bedingungen und zulässige Werte.

Neuzulassung

Erforderlich: FIN, eVB, ZB-II-Nummer, ZB-II-Sicherheitscode und Kennzeichenoption.

Pflicht immer sendenBedingt Bedingung im Text beachten

Feld	Typ	Angabe	Beschreibung
`procedure`	string	Pflicht	Vorgangscode: AB, WG, WZ, NZ, TZ, UG oder HA.
`holder_id`	string	Optional	Wird nur als Referenz gespeichert. Keine Verifizierung erforderlich.
`contract_partner_id`	string	Optional	ID eines im Dashboard hinterlegten Vertragspartners (cpt_…). KOPA-Schlüssel und Stammdaten werden intern aufgelöst und nicht im API-Request gesendet.
`external_reference`	string	Optional	Eigene Auftrags- oder Fahrzeugreferenz; maximal 120 Zeichen.
`vehicle.vin`	string	Pflicht	17-stellige Fahrzeug-Identifizierungsnummer ohne I, O oder Q.
`vehicle.type`	enum	Optional	car, motorcycle oder trailer; Standard ist car.
`vehicle.drive_type`	enum	Bedingt	combustion, hybrid oder electric; nur bei Anhängern nicht erforderlich.
`registration.certificate_part_1_security_code`	string	Pflicht	Siebenstelliger Sicherheitscode der ZB I.
`registration.current_license_plate.district`	string	Pflicht	Unterscheidungszeichen des aktuellen Kennzeichens, etwa HB.
`registration.current_license_plate.letters`	string	Pflicht	Ein oder zwei Buchstaben des aktuellen Kennzeichens.
`registration.current_license_plate.number`	string	Pflicht	Eine bis vier Ziffern ohne führende Null.
`registration.current_license_plate.security_codes.rear`	string	Pflicht	Sicherheitscode des hinteren Kennzeichens, ein bis drei Zeichen.
`registration.current_license_plate.security_codes.front`	string	Bedingt	Bei Pkw erforderlich; Motorräder und Anhänger tragen nur hinten ein Kennzeichen.
`registration.license_plate.option`	enum	Optional	Falls gesendet, ist ausschließlich keep erlaubt.
`registration.reserve_current_license_plate`	boolean	Optional	true reserviert das bisherige Kennzeichen; Standard ist false.
`procedure`	string	Pflicht	Vorgangscode: AB, WG, WZ, NZ, TZ, UG oder HA.
`holder_id`	string	Bedingt	Bei third_party erforderlich. Bei company wird der Dashboard-Halter verwendet.
`contract_partner_id`	string	Optional	ID eines im Dashboard hinterlegten Vertragspartners (cpt_…). KOPA-Schlüssel und Stammdaten werden intern aufgelöst und nicht im API-Request gesendet.
`external_reference`	string	Optional	Eigene Auftrags- oder Fahrzeugreferenz; maximal 120 Zeichen.
`vehicle.vin`	string	Pflicht	17-stellige Fahrzeug-Identifizierungsnummer ohne I, O oder Q.
`vehicle.type`	enum	Optional	car, motorcycle oder trailer; Standard ist car.
`vehicle.drive_type`	enum	Bedingt	combustion, hybrid oder electric; nur bei Anhängern nicht erforderlich.
`vehicle.evb_number`	string	Pflicht	Siebenstellige elektronische Versicherungsbestätigung.
`registration.certificate_part_1_security_code`	string	Pflicht	Siebenstelliger Sicherheitscode der ZB I.
`registration.certificate_part_2.security_code`	string	Pflicht	Zwölfstelliger Sicherheitscode der ZB II.
`registration.current_license_plate.district`	string	Pflicht	Unterscheidungszeichen des aktuellen Kennzeichens, etwa HB.
`registration.current_license_plate.letters`	string	Pflicht	Ein oder zwei Buchstaben des aktuellen Kennzeichens.
`registration.current_license_plate.number`	string	Pflicht	Eine bis vier Ziffern ohne führende Null.
`registration.license_plate.option`	enum	Pflicht	reserved, keep oder next_available; die erlaubten Werte hängen vom Vorgang ab.
`registration.license_plate.reservation_id`	string	Bedingt	ID einer Reservierung aus /api/v1/license-plate-reservations.
`payment.iban`	string	Bedingt	Bei third_party erforderlich. Bei company verwendet die API die im Dashboard hinterlegte IBAN.
`signer.email`	email	Bedingt	Erforderlich, wenn weder beim Halter noch in Ihrem Dashboard-Konto eine E-Mail-Adresse hinterlegt ist.
`procedure`	string	Pflicht	Vorgangscode: AB, WG, WZ, NZ, TZ, UG oder HA.
`holder_id`	string	Bedingt	Bei third_party erforderlich. Bei company wird der Dashboard-Halter verwendet.
`contract_partner_id`	string	Optional	ID eines im Dashboard hinterlegten Vertragspartners (cpt_…). KOPA-Schlüssel und Stammdaten werden intern aufgelöst und nicht im API-Request gesendet.
`external_reference`	string	Optional	Eigene Auftrags- oder Fahrzeugreferenz; maximal 120 Zeichen.
`vehicle.vin`	string	Pflicht	17-stellige Fahrzeug-Identifizierungsnummer ohne I, O oder Q.
`vehicle.type`	enum	Optional	car, motorcycle oder trailer; Standard ist car.
`vehicle.drive_type`	enum	Bedingt	combustion, hybrid oder electric; nur bei Anhängern nicht erforderlich.
`vehicle.evb_number`	string	Pflicht	Siebenstellige elektronische Versicherungsbestätigung.
`registration.certificate_part_1_security_code`	string	Pflicht	Siebenstelliger Sicherheitscode der ZB I.
`registration.current_license_plate.district`	string	Pflicht	Unterscheidungszeichen des aktuellen Kennzeichens, etwa HB.
`registration.current_license_plate.letters`	string	Pflicht	Ein oder zwei Buchstaben des aktuellen Kennzeichens.
`registration.current_license_plate.number`	string	Pflicht	Eine bis vier Ziffern ohne führende Null.
`registration.license_plate.option`	enum	Pflicht	reserved, keep oder next_available; die erlaubten Werte hängen vom Vorgang ab.
`registration.license_plate.reservation_id`	string	Bedingt	ID einer Reservierung aus /api/v1/license-plate-reservations.
`payment.iban`	string	Bedingt	Bei third_party erforderlich. Bei company verwendet die API die im Dashboard hinterlegte IBAN.
`signer.email`	email	Bedingt	Erforderlich, wenn weder beim Halter noch in Ihrem Dashboard-Konto eine E-Mail-Adresse hinterlegt ist.
`procedure`	string	Pflicht	Vorgangscode: AB, WG, WZ, NZ, TZ, UG oder HA.
`holder_id`	string	Bedingt	Bei third_party erforderlich. Bei company wird der Dashboard-Halter verwendet.
`contract_partner_id`	string	Optional	ID eines im Dashboard hinterlegten Vertragspartners (cpt_…). KOPA-Schlüssel und Stammdaten werden intern aufgelöst und nicht im API-Request gesendet.
`external_reference`	string	Optional	Eigene Auftrags- oder Fahrzeugreferenz; maximal 120 Zeichen.
`vehicle.vin`	string	Pflicht	17-stellige Fahrzeug-Identifizierungsnummer ohne I, O oder Q.
`vehicle.type`	enum	Optional	car, motorcycle oder trailer; Standard ist car.
`vehicle.drive_type`	enum	Bedingt	combustion, hybrid oder electric; nur bei Anhängern nicht erforderlich.
`vehicle.evb_number`	string	Pflicht	Siebenstellige elektronische Versicherungsbestätigung.
`registration.certificate_part_2.number`	string	Pflicht	Dokumentennummer der ZB II mit maximal zwölf Zeichen.
`registration.certificate_part_2.security_code`	string	Pflicht	Zwölfstelliger Sicherheitscode der ZB II.
`registration.license_plate.option`	enum	Pflicht	reserved oder next_available; keep ist bei NZ nicht erlaubt.
`registration.license_plate.reservation_id`	string	Bedingt	ID einer Reservierung aus /api/v1/license-plate-reservations.
`payment.iban`	string	Bedingt	Bei third_party erforderlich. Bei company verwendet die API die im Dashboard hinterlegte IBAN.
`signer.email`	email	Bedingt	Erforderlich, wenn weder beim Halter noch in Ihrem Dashboard-Konto eine E-Mail-Adresse hinterlegt ist.
`procedure`	string	Pflicht	Vorgangscode: AB, WG, WZ, NZ, TZ, UG oder HA.
`holder_id`	string	Bedingt	Bei third_party erforderlich. Bei company wird der Dashboard-Halter verwendet.
`contract_partner_id`	string	Optional	ID eines im Dashboard hinterlegten Vertragspartners (cpt_…). KOPA-Schlüssel und Stammdaten werden intern aufgelöst und nicht im API-Request gesendet.
`external_reference`	string	Optional	Eigene Auftrags- oder Fahrzeugreferenz; maximal 120 Zeichen.
`vehicle.vin`	string	Pflicht	17-stellige Fahrzeug-Identifizierungsnummer ohne I, O oder Q.
`vehicle.type`	enum	Optional	car, motorcycle oder trailer; Standard ist car.
`vehicle.drive_type`	enum	Bedingt	combustion, hybrid oder electric; nur bei Anhängern nicht erforderlich.
`vehicle.evb_number`	string	Pflicht	Siebenstellige elektronische Versicherungsbestätigung.
`registration.certificate_part_2.number`	string	Pflicht	Dokumentennummer der ZB II mit maximal zwölf Zeichen.
`registration.certificate_part_2.security_code`	string	Pflicht	Zwölfstelliger Sicherheitscode der ZB II.
`registration.license_plate.option`	enum	Pflicht	reserved oder next_available; keep ist bei TZ nicht erlaubt.
`registration.license_plate.reservation_id`	string	Bedingt	ID einer Reservierung aus /api/v1/license-plate-reservations.
`payment.iban`	string	Bedingt	Bei third_party erforderlich. Bei company verwendet die API die im Dashboard hinterlegte IBAN.
`signer.email`	email	Bedingt	Erforderlich, wenn weder beim Halter noch in Ihrem Dashboard-Konto eine E-Mail-Adresse hinterlegt ist.
`procedure`	string	Pflicht	Vorgangscode: AB, WG, WZ, NZ, TZ, UG oder HA.
`holder_id`	string	Bedingt	Bei third_party erforderlich. Bei company wird der Dashboard-Halter verwendet.
`contract_partner_id`	string	Optional	ID eines im Dashboard hinterlegten Vertragspartners (cpt_…). KOPA-Schlüssel und Stammdaten werden intern aufgelöst und nicht im API-Request gesendet.
`external_reference`	string	Optional	Eigene Auftrags- oder Fahrzeugreferenz; maximal 120 Zeichen.
`vehicle.vin`	string	Pflicht	17-stellige Fahrzeug-Identifizierungsnummer ohne I, O oder Q.
`vehicle.type`	enum	Optional	car, motorcycle oder trailer; Standard ist car.
`vehicle.drive_type`	enum	Bedingt	combustion, hybrid oder electric; nur bei Anhängern nicht erforderlich.
`vehicle.evb_number`	string	Pflicht	Siebenstellige elektronische Versicherungsbestätigung.
`registration.holder_change`	boolean	Pflicht	true für Halterwechsel, false für Umschreibung ohne Halterwechsel.
`registration.certificate_part_1_security_code`	string	Pflicht	Siebenstelliger Sicherheitscode der ZB I.
`registration.certificate_part_2.security_code`	string	Bedingt	Pflicht bei holder_change: true; bei false nicht erforderlich.
`registration.current_license_plate.district`	string	Pflicht	Unterscheidungszeichen des aktuellen Kennzeichens, etwa HB.
`registration.current_license_plate.letters`	string	Pflicht	Ein oder zwei Buchstaben des aktuellen Kennzeichens.
`registration.current_license_plate.number`	string	Pflicht	Eine bis vier Ziffern ohne führende Null.
`registration.current_license_plate.security_codes.rear`	string	Bedingt	Pflicht, wenn ein neues Kennzeichen zugeteilt oder reserviert wird.
`registration.current_license_plate.security_codes.front`	string	Bedingt	Zusätzlich bei Kennzeichenwechsel eines Pkw; nicht bei Motorrad oder Anhänger.
`registration.license_plate.option`	enum	Pflicht	reserved, keep oder next_available; die erlaubten Werte hängen vom Vorgang ab.
`registration.license_plate.reservation_id`	string	Bedingt	ID einer Reservierung aus /api/v1/license-plate-reservations.
`payment.iban`	string	Bedingt	Bei third_party erforderlich. Bei company verwendet die API die im Dashboard hinterlegte IBAN.
`signer.email`	email	Bedingt	Erforderlich, wenn weder beim Halter noch in Ihrem Dashboard-Konto eine E-Mail-Adresse hinterlegt ist.
`procedure`	string	Pflicht	Vorgangscode: AB, WG, WZ, NZ, TZ, UG oder HA.
`holder_id`	string	Bedingt	Bei third_party erforderlich. Bei company wird der Dashboard-Halter verwendet.
`contract_partner_id`	string	Optional	ID eines im Dashboard hinterlegten Vertragspartners (cpt_…). KOPA-Schlüssel und Stammdaten werden intern aufgelöst und nicht im API-Request gesendet.
`external_reference`	string	Optional	Eigene Auftrags- oder Fahrzeugreferenz; maximal 120 Zeichen.
`vehicle.vin`	string	Pflicht	17-stellige Fahrzeug-Identifizierungsnummer ohne I, O oder Q.
`vehicle.type`	enum	Optional	car, motorcycle oder trailer; Standard ist car.
`vehicle.drive_type`	enum	Bedingt	combustion, hybrid oder electric; nur bei Anhängern nicht erforderlich.
`registration.certificate_part_1_security_code`	string	Pflicht	Siebenstelliger Sicherheitscode der ZB I.
`registration.current_license_plate.district`	string	Pflicht	Unterscheidungszeichen des aktuellen Kennzeichens, etwa HB.
`registration.current_license_plate.letters`	string	Pflicht	Ein oder zwei Buchstaben des aktuellen Kennzeichens.
`registration.current_license_plate.number`	string	Pflicht	Eine bis vier Ziffern ohne führende Null.
`registration.license_plate.option`	enum	Optional	Falls gesendet, ist ausschließlich keep erlaubt.
`signer.email`	email	Bedingt	Erforderlich, wenn weder beim Halter noch in Ihrem Dashboard-Konto eine E-Mail-Adresse hinterlegt ist.

Optionale Felder

Felder für Kennzeichenoptionen, Zustellung, Steuer und Zusatzbestellungen.

Feld	Typ	Angabe	Beschreibung
`submission_mode`	enum	Optional	company oder third_party. Wird aus holder_id beziehungsweise holder abgeleitet; mit contract_partner_id bedeutet company, dass der Vertragspartner zugleich Antragsteller und Halter ist.
`registration.current_license_plate.seasonal`	object	Optional	Bei Saisonkennzeichen enabled, start_month und end_month angeben.
`registration.current_license_plate.electric`	boolean	Optional	Das bisherige Kennzeichen ist ein E-Kennzeichen.
`registration.recycling_certificate`	object	Optional	Optionaler Verwertungsnachweis mit länderspezifischen Pflichtfeldern.
`submission_mode`	enum	Optional	company oder third_party. Wird aus holder_id beziehungsweise holder abgeleitet; mit contract_partner_id bedeutet company, dass der Vertragspartner zugleich Antragsteller und Halter ist.
`signature_profile_id`	string	Optional	Signaturprofil (sgp_…) aus demselben Konto und derselben Umgebung. Bestimmt Absendername, Logo und Redirect der Signaturanfrage.
`vehicle.electric_plate`	boolean	Optional	E-Kennzeichen für das neu zugeteilte Kennzeichen anfordern. Nicht zusammen mit historic_plate.
`vehicle.historic_plate`	boolean	Optional	H-Kennzeichen für das neu zugeteilte Kennzeichen anfordern. Nicht zusammen mit electric_plate.
`registration.current_license_plate.seasonal`	object	Optional	Bei Saisonkennzeichen enabled, start_month und end_month angeben.
`registration.current_license_plate.electric`	boolean	Optional	Das bisherige Kennzeichen ist ein E-Kennzeichen.
`registration.license_plate.{district,letters,number,pin}`	strings	Bedingt	Alternative zu reservation_id, wenn ein extern reserviertes Kennzeichen verwendet wird.
`registration.license_plate.seasonal`	object	Optional	Saisonzeitraum für das neue Kennzeichen.
`payment.account_holder`	string	Optional	Kontoinhaber; wird andernfalls aus dem Halter abgeleitet.
`payment.bic`	string	Optional	BIC mit acht oder elf Zeichen.
`payment.tax_exempt`	boolean	Optional	Beantragung einer Kfz-Steuerbefreiung; Standard ist false.
`registration.authorized_party`	object	Optional	Bevollmächtigte Person oder Firma mit vollständiger Anschrift.
`registration.delivery.part_1 / part_2`	object	Optional	Abweichende Zustellung oder Abholung von ZB I und ZB II.
`additional_services.license_plates.ordered`	boolean	Optional	Kennzeichenschilder antragsgebunden bestellen; nicht bei Beibehaltung des bisherigen Kennzeichens.
`additional_services.license_plates.{quantity,size}`	integer, enum	Bedingt	Bei Bestellung optional: 1–10 Schilder und eines der dokumentierten Formate.
`additional_services.emissions_sticker.ordered`	boolean	Optional	Feinstaubplakette antragsgebunden bestellen; nur für Pkw.
`submission_mode`	enum	Optional	company oder third_party. Wird aus holder_id beziehungsweise holder abgeleitet; mit contract_partner_id bedeutet company, dass der Vertragspartner zugleich Antragsteller und Halter ist.
`signature_profile_id`	string	Optional	Signaturprofil (sgp_…) aus demselben Konto und derselben Umgebung. Bestimmt Absendername, Logo und Redirect der Signaturanfrage.
`vehicle.electric_plate`	boolean	Optional	E-Kennzeichen für das neu zugeteilte Kennzeichen anfordern. Nicht zusammen mit historic_plate.
`vehicle.historic_plate`	boolean	Optional	H-Kennzeichen für das neu zugeteilte Kennzeichen anfordern. Nicht zusammen mit electric_plate.
`registration.current_license_plate.seasonal`	object	Optional	Bei Saisonkennzeichen enabled, start_month und end_month angeben.
`registration.current_license_plate.electric`	boolean	Optional	Das bisherige Kennzeichen ist ein E-Kennzeichen.
`registration.license_plate.{district,letters,number,pin}`	strings	Bedingt	Alternative zu reservation_id, wenn ein extern reserviertes Kennzeichen verwendet wird.
`registration.license_plate.seasonal`	object	Optional	Saisonzeitraum für das neue Kennzeichen.
`payment.account_holder`	string	Optional	Kontoinhaber; wird andernfalls aus dem Halter abgeleitet.
`payment.bic`	string	Optional	BIC mit acht oder elf Zeichen.
`payment.tax_exempt`	boolean	Optional	Beantragung einer Kfz-Steuerbefreiung; Standard ist false.
`registration.authorized_party`	object	Optional	Bevollmächtigte Person oder Firma mit vollständiger Anschrift.
`registration.delivery.part_1 / part_2`	object	Optional	Abweichende Zustellung oder Abholung von ZB I und ZB II.
`additional_services.license_plates.ordered`	boolean	Optional	Kennzeichenschilder antragsgebunden bestellen; nicht bei Beibehaltung des bisherigen Kennzeichens.
`additional_services.license_plates.{quantity,size}`	integer, enum	Bedingt	Bei Bestellung optional: 1–10 Schilder und eines der dokumentierten Formate.
`additional_services.emissions_sticker.ordered`	boolean	Optional	Feinstaubplakette antragsgebunden bestellen; nur für Pkw.
`submission_mode`	enum	Optional	company oder third_party. Wird aus holder_id beziehungsweise holder abgeleitet; mit contract_partner_id bedeutet company, dass der Vertragspartner zugleich Antragsteller und Halter ist.
`signature_profile_id`	string	Optional	Signaturprofil (sgp_…) aus demselben Konto und derselben Umgebung. Bestimmt Absendername, Logo und Redirect der Signaturanfrage.
`vehicle.electric_plate`	boolean	Optional	E-Kennzeichen für das neu zugeteilte Kennzeichen anfordern. Nicht zusammen mit historic_plate.
`vehicle.historic_plate`	boolean	Optional	H-Kennzeichen für das neu zugeteilte Kennzeichen anfordern. Nicht zusammen mit electric_plate.
`vehicle.requested_registration_date`	date	Optional	Gewünschtes Datum der Erstzulassung im Format YYYY-MM-DD.
`registration.license_plate.{district,letters,number,pin}`	strings	Bedingt	Alternative zu reservation_id, wenn ein extern reserviertes Kennzeichen verwendet wird.
`registration.license_plate.seasonal`	object	Optional	Saisonzeitraum für das neue Kennzeichen.
`payment.account_holder`	string	Optional	Kontoinhaber; wird andernfalls aus dem Halter abgeleitet.
`payment.bic`	string	Optional	BIC mit acht oder elf Zeichen.
`payment.tax_exempt`	boolean	Optional	Beantragung einer Kfz-Steuerbefreiung; Standard ist false.
`registration.authorized_party`	object	Optional	Bevollmächtigte Person oder Firma mit vollständiger Anschrift.
`registration.delivery.part_1 / part_2`	object	Optional	Abweichende Zustellung oder Abholung von ZB I und ZB II.
`additional_services.license_plates.ordered`	boolean	Optional	Kennzeichenschilder antragsgebunden bestellen; nicht bei Beibehaltung des bisherigen Kennzeichens.
`additional_services.license_plates.{quantity,size}`	integer, enum	Bedingt	Bei Bestellung optional: 1–10 Schilder und eines der dokumentierten Formate.
`additional_services.emissions_sticker.ordered`	boolean	Optional	Feinstaubplakette antragsgebunden bestellen; nur für Pkw.
`submission_mode`	enum	Optional	company oder third_party. Wird aus holder_id beziehungsweise holder abgeleitet; mit contract_partner_id bedeutet company, dass der Vertragspartner zugleich Antragsteller und Halter ist.
`signature_profile_id`	string	Optional	Signaturprofil (sgp_…) aus demselben Konto und derselben Umgebung. Bestimmt Absendername, Logo und Redirect der Signaturanfrage.
`vehicle.electric_plate`	boolean	Optional	E-Kennzeichen für das neu zugeteilte Kennzeichen anfordern. Nicht zusammen mit historic_plate.
`vehicle.historic_plate`	boolean	Optional	H-Kennzeichen für das neu zugeteilte Kennzeichen anfordern. Nicht zusammen mit electric_plate.
`vehicle.requested_registration_date`	date	Optional	Gewünschtes Datum der Erstzulassung im Format YYYY-MM-DD.
`registration.license_plate.{district,letters,number,pin}`	strings	Bedingt	Alternative zu reservation_id, wenn ein extern reserviertes Kennzeichen verwendet wird.
`registration.license_plate.seasonal`	object	Optional	Saisonzeitraum für das neue Kennzeichen.
`payment.account_holder`	string	Optional	Kontoinhaber; wird andernfalls aus dem Halter abgeleitet.
`payment.bic`	string	Optional	BIC mit acht oder elf Zeichen.
`payment.tax_exempt`	boolean	Optional	Beantragung einer Kfz-Steuerbefreiung; Standard ist false.
`registration.authorized_party`	object	Optional	Bevollmächtigte Person oder Firma mit vollständiger Anschrift.
`registration.delivery.part_1 / part_2`	object	Optional	Abweichende Zustellung oder Abholung von ZB I und ZB II.
`additional_services.license_plates.ordered`	boolean	Optional	Kennzeichenschilder antragsgebunden bestellen; nicht bei Beibehaltung des bisherigen Kennzeichens.
`additional_services.license_plates.{quantity,size}`	integer, enum	Bedingt	Bei Bestellung optional: 1–10 Schilder und eines der dokumentierten Formate.
`additional_services.emissions_sticker.ordered`	boolean	Optional	Feinstaubplakette antragsgebunden bestellen; nur für Pkw.
`submission_mode`	enum	Optional	company oder third_party. Wird aus holder_id beziehungsweise holder abgeleitet; mit contract_partner_id bedeutet company, dass der Vertragspartner zugleich Antragsteller und Halter ist.
`signature_profile_id`	string	Optional	Signaturprofil (sgp_…) aus demselben Konto und derselben Umgebung. Bestimmt Absendername, Logo und Redirect der Signaturanfrage.
`vehicle.electric_plate`	boolean	Optional	E-Kennzeichen für das neu zugeteilte Kennzeichen anfordern. Nicht zusammen mit historic_plate.
`vehicle.historic_plate`	boolean	Optional	H-Kennzeichen für das neu zugeteilte Kennzeichen anfordern. Nicht zusammen mit electric_plate.
`registration.current_license_plate.seasonal`	object	Optional	Bei Saisonkennzeichen enabled, start_month und end_month angeben.
`registration.current_license_plate.electric`	boolean	Optional	Das bisherige Kennzeichen ist ein E-Kennzeichen.
`registration.license_plate.{district,letters,number,pin}`	strings	Bedingt	Alternative zu reservation_id, wenn ein extern reserviertes Kennzeichen verwendet wird.
`registration.license_plate.seasonal`	object	Optional	Saisonzeitraum für das neue Kennzeichen.
`payment.account_holder`	string	Optional	Kontoinhaber; wird andernfalls aus dem Halter abgeleitet.
`payment.bic`	string	Optional	BIC mit acht oder elf Zeichen.
`payment.tax_exempt`	boolean	Optional	Beantragung einer Kfz-Steuerbefreiung; Standard ist false.
`registration.authorized_party`	object	Optional	Bevollmächtigte Person oder Firma mit vollständiger Anschrift.
`registration.delivery.part_1 / part_2`	object	Optional	Abweichende Zustellung oder Abholung von ZB I und ZB II.
`additional_services.license_plates.ordered`	boolean	Optional	Kennzeichenschilder antragsgebunden bestellen; nicht bei Beibehaltung des bisherigen Kennzeichens.
`additional_services.license_plates.{quantity,size}`	integer, enum	Bedingt	Bei Bestellung optional: 1–10 Schilder und eines der dokumentierten Formate.
`additional_services.emissions_sticker.ordered`	boolean	Optional	Feinstaubplakette antragsgebunden bestellen; nur für Pkw.
`submission_mode`	enum	Optional	company oder third_party. Wird aus holder_id beziehungsweise holder abgeleitet; mit contract_partner_id bedeutet company, dass der Vertragspartner zugleich Antragsteller und Halter ist.
`signature_profile_id`	string	Optional	Signaturprofil (sgp_…) aus demselben Konto und derselben Umgebung. Bestimmt Absendername, Logo und Redirect der Signaturanfrage.
`registration.current_license_plate.seasonal`	object	Optional	Bei Saisonkennzeichen enabled, start_month und end_month angeben.
`registration.current_license_plate.electric`	boolean	Optional	Das bisherige Kennzeichen ist ein E-Kennzeichen.
`registration.authorized_party`	object	Optional	Bevollmächtigte Person oder Firma mit vollständiger Anschrift.
`registration.delivery.part_1 / part_2`	object	Optional	Abweichende Zustellung oder Abholung von ZB I und ZB II.

{
  "procedure": "NZ",
  "holder_id": "hld_live_7f3a92c41b6d8e2054fa1c09",
  "external_reference": "fleet-2026-nz-0042",
  "vehicle": {
    "vin": "WVWZZZ1JZXW000001",
    "type": "car",
    "drive_type": "combustion",
    "evb_number": "ABCD123"
  },
  "registration": {
    "certificate_part_2": {
      "number": "ZB2A123456",
      "security_code": "B1234567890X"
    },
    "license_plate": {
      "option": "next_available"
    }
  },
  "payment": {
    "iban": "DE89370400440532013000",
    "account_holder": "Mara Beispiel",
    "tax_exempt": false
  },
  "additional_services": {
    "license_plates": {
      "ordered": true,
      "quantity": 2,
      "size": "520x110"
    },
    "emissions_sticker": {
      "ordered": true
    }
  },
  "signer": {
    "email": "signatur@beispiel-mobilitaet.example"
  }
}

SchemaquelleOpenAPI 3.1 herunterladen

Responses

201

Antrag angelegt; die Antwort enthält den gespeicherten Anfangszustand und gegebenenfalls next_action.

401/403

API-Schlüssel, Live-Umgebung oder Scope applications:write ist ungültig.

409

Idempotenzkonflikt oder referenzierte Ressource ist nicht mehr verwendbar.

422

Pflichtfeld, Halterstatus oder Geschäftsvorfall ist fachlich ungültig.

429/503

Rate Limit oder vorübergehend nicht verfügbarer Dienst; Retry-Header beachten.

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 Antrags-ID.
`object`	string	Immer	Konstanter Wert `vehicle_registration_application`.
`environment`	enum	Immer	`test` oder `live`.
`livemode`	boolean	Immer	`true` bei Produktivanträgen.
`procedure`	enum	Immer	Ausgeschriebener Vorgang.
`procedure_code`	enum	Immer	`AB`, `WG`, `WZ`, `NZ`, `TZ`, `UG` oder `HA`.
`submission_mode`	enum	Immer	`company` oder `third_party`.
`contract_partner_id`	string	Optional	Beim Anlegen gebundener Vertragspartner. KOPA-Schlüssel und Stammdaten werden nicht ausgegeben.
`holder`	object	Optional	Gespeicherte Halter-ID, Revision und Verifizierungsstatus. Fehlt bei AB ohne Halterreferenz.
`external_reference`	string	Optional	Beim Anlegen übergebene Referenz.
`signature_profile`	string	Optional	Beim Anlegen gebundenes Signaturprofil. Fehlt ohne Profilangabe.
`status`	enum	Immer	Aktueller Antragsstatus. Dieses Feld für Programmlogik verwenden.
`status_details`	object	Immer	Anzeigetext, Änderungszeitpunkt und gegebenenfalls Fehlerangaben.
`next_action`	object	Optional	Nächste Clientaktion, beispielsweise Signatur oder Fehlerbehebung.
`signature`	object	Immer	Signaturpflicht, Status und gegebenenfalls Signatur-URL.
`results`	object	Immer	Aktuelle Entscheidung und alle bereits verfügbaren KBA-, Kennzeichen- und Behördenwerte. Optionale Unterfelder werden ausgelassen, solange kein Wert vorliegt.
`results.decision`	enum	Immer	`pending`, `approved`, `rejected` oder `manual_review`. Zusammen mit `status` für Programmlogik verwenden.
`results.failure_code`	string	Optional	Stabiler maschinenlesbarer Code eines fehlgeschlagenen Testereignisses. Kein KBA-Quittungscode.
`results.kba_application_number`	string	Optional	Vom KBA vergebene Antragsnummer, sobald sie für den Antrag vorliegt. Nicht mit der öffentlichen `id` oder `external_reference` verwechseln. Ein erfolgreicher Testabschluss liefert eine simulierte Nummer mit Präfix `KBA-TEST-`.
`results.assigned_license_plate`	string	Optional	Dem Antrag zugeordnetes Kennzeichen, sobald es als Ergebniswert vorliegt.
`results.authority_status`	array	Optional	Alle freigebbaren Code-/Message-Paare der aktuellsten Behördenquittung. Das Feld ist kein Quittungsverlauf und kann auch bei `status: failed` fehlen.
`results.authority_status[].code`	string	Bedingt	Fünfstelliger Quittungscode der Live-Behördenantwort. Führende Nullen bleiben erhalten. Ein erfolgreicher Testabschluss liefert `0000`.
`results.authority_status[].message`	string	Bedingt	Die diesem Code zugeordnete offizielle Message. Nicht für Programmlogik verwenden.
`documents`	array	Immer	Metadaten bereitgestellter Dokumente.
`orders_url`	string	Immer	URL der antragsgebundenen Zusatzbestellungen.
`fees`	object	Optional	Aktuelle Gebührenrevision in Euro-Cent.
`tariff`	object	Optional	Tarifinformationen.
`timestamps`	object	Immer	Erstellungs-, Änderungs- und Statuszeitpunkt.
`warnings`	array	Optional	Nicht blockierende Hinweise.

{
  "id": "app_live_7f3a92c41b6d8e2054fa1c09",
  "object": "vehicle_registration_application",
  "environment": "live",
  "livemode": true,
  "procedure": "new_registration",
  "procedure_code": "NZ",
  "submission_mode": "third_party",
  "contract_partner_id": "cpt_live_0123456789abcdef01234567",
  "holder": {
    "id": "hld_live_7f3a92c41b6d8e2054fa1c09",
    "revision": 1,
    "verification_status": "verified"
  },
  "external_reference": "fleet-2026-0042",
  "status": "awaiting_signature",
  "status_details": {
    "label": "Freigabe ausstehend",
    "updated_at": "2026-08-23T10:42:18+02:00"
  },
  "next_action": {
    "type": "sign_application",
    "url": "https://digital-zulassen.de/antrag/link/?token=example"
  },
  "signature": {
    "required": true,
    "status": "pending",
    "url": "https://digital-zulassen.de/antrag/link/?token=example"
  },
  "results": {
    "decision": "pending"
  },
  "documents": [],
  "orders_url": "/api/v1/applications/app_live_7f3a92c41b6d8e2054fa1c09/orders",
  "timestamps": {
    "created_at": "2026-08-23T10:42:18+02:00",
    "updated_at": "2026-08-23T10:42:18+02:00",
    "status_updated_at": "2026-08-23T10:42:18+02:00"
  }
}

Vor dem Aufruf

Verwenden Sie einen aktiven dz_live_…-Schlüssel mit applications:write.
Verwenden Sie pro neuem Antrag einen neuen Idempotency-Key. Wiederholen Sie einen Request nach Timeout oder Verbindungsfehler mit demselben Schlüssel.
Prüfen Sie Geschäftsvorfall und Halterkonstellation, bevor Sie personenbezogene Daten übertragen.
Senden Sie nur dokumentierte Feldnamen.

Halterreferenz

Verwenden Sie holder_id. Der Antrag speichert den Datenstand des Halters zum Zeitpunkt der Erstellung; spätere Änderungen am Halter wirken nicht auf den Antrag.

Mit holder_id oder inline holder gilt der Antrag als Zulassung für Dritte (submission_mode: third_party). Ohne Halterangabe ist es eine Eigenzulassung (company) — Halterdaten und Bankverbindung kommen dann aus Ihrem Dashboard-Konto und eine Signatur je Antrag entfällt. Bei AB bleibt holder ohne übergebene Halterreferenz leer.

Das inline holder-Objekt bleibt für bestehende Integrationen verfügbar. Neue Integrationen sollten Halter über /api/v1/holders anlegen.

Wann der Halter verifiziert sein muss

Reichen Sie mit Vollmacht auf Digital-Zulassen ein, muss der Halter verifiziert sein. Andernfalls antwortet die API mit holder_verification_required.

Sind Sie selbst beim KBA als Großkunde registriert und reichen über Ihren eigenen Großkundenzugang ein, entfällt die Halterverifizierung: Sie prüfen die Halterdaten in eigener Verantwortung, unverifizierte Personen- und Unternehmenshalter sind zulässig. Diese Freischaltung wird im Dashboard-Konto hinterlegt und lässt sich nicht über ein Request-Feld aktivieren.

Für procedure: AB ist keine Halterreferenz erforderlich. Eine gesendete holder_id oder ein inline holder wird nur als Referenz gespeichert. Ohne Halterangabe bleibt holder leer. AB erfordert weder Halterverifizierung noch QES oder Antragssignatur.

Vertragspartner als Antragsteller

Senden Sie ausschließlich die im Dashboard bereitgestellte contract_partner_id. KOPA-Schlüssel, Name und Anschrift des Vertragspartners werden kontogebunden aufgelöst; sie sind keine API-Felder.

Ohne abweichenden Halter (submission_mode: company) ist der Vertragspartner Antragsteller und Halter. Antragsteller- und Halterkomponente werden fachlich identisch erzeugt; eine Vollmacht entfällt.

Mit holder_id (submission_mode: third_party) bleibt der Vertragspartner Antragsteller. Der referenzierte Halter ist Vollmachtgeber und die Vollmacht bleibt erforderlich.

Zusatzbestellungen

Über additional_services können Kennzeichenschilder und eine Feinstaubplakette mit dem Antrag bestellt werden. Der Bestellstatus steht in eigenen Order-Ressourcen und ist unabhängig vom Antragsstatus.

Response

201 Created bestätigt die Anlage. Die Antwort enthält das Antragsobjekt; der weitere Zustand steht in status.

Bei next_action.type: sign_application muss die URL an die signierende Person übergeben werden. Die URL darf nicht protokolliert oder öffentlich weitergegeben werden. Bei AB gilt signature.required: false und signature.status: not_required; es wird kein Signaturlink erzeugt.