Testantrag anlegen

Der Request entspricht dem produktiven Anlageformat. Weitere Zustände werden über Testereignisse gesetzt.

Beschreibung

Legt einen gespeicherten Testantrag ohne KBA-Übergabe an.

Parameter

Idempotency-KeyheaderPflicht

Eindeutiger Schlüssel für die Testanlage.

Beispiel: test_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_test_1a2b3c4d5e6f708192a3b4c5",
  "external_reference": "test-ci-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-test@beispiel-mobilitaet.example"
  }
}

SchemaquelleOpenAPI 3.1 herunterladen

Responses

201

Testantrag gespeichert; keine KBA-Übergabe.

401/403

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

409

Idempotenzkonflikt.

422

Requestdaten oder Testressourcen sind ungültig.

429

Rate Limit oder tägliches Testanlagen-Budget erreicht.

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_test_1a2b3c4d5e6f708192a3b4c5",
  "object": "vehicle_registration_application",
  "environment": "test",
  "livemode": false,
  "procedure": "new_registration",
  "procedure_code": "NZ",
  "submission_mode": "third_party",
  "holder": {
    "id": "hld_test_1a2b3c4d5e6f708192a3b4c5",
    "revision": 1,
    "verification_status": "verified"
  },
  "external_reference": "test-ci-1042",
  "status": "awaiting_signature",
  "status_details": {
    "label": "Freigabe ausstehend",
    "updated_at": "2026-08-23T10:42:18+02:00"
  },
  "next_action": {
    "type": "sign_application",
    "url": "/api/v1/test/signatures/0123456789abcdef0123456789abcdef0123456789abcdef"
  },
  "signature": {
    "required": true,
    "status": "pending",
    "url": "/api/v1/test/signatures/0123456789abcdef0123456789abcdef0123456789abcdef"
  },
  "results": {
    "decision": "pending"
  },
  "documents": [],
  "orders_url": "/api/v1/applications/app_test_1a2b3c4d5e6f708192a3b4c5/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"
  }
}

Testisolierung

Testanträge tragen environment: test und livemode: false. Der KBA-Versand ist unabhängig von UI oder Requestdaten serverseitig ausgeschlossen.

Ein dz_live_…-Schlüssel wird an diesem Endpunkt abgewiesen. Umgekehrt darf ein dz_test_…-Schlüssel keinen produktiven Antrag anlegen. Der Testendpunkt benötigt applications:write.

Teststatus setzen

Testereignis	Zweck
`signature.completed`	Den Signaturschritt abschließen.
`processing.started`	Den Status auf processing setzen.
`application.completed`	Erfolgreichen Abschluss mit Testdokument und Testgebühr erzeugen.
`application.failed`	Einen fehlgeschlagenen Antrag simulieren.

Tagesbudget und Aufbewahrung

Neue Testanlagen teilen sich pro Konto ein tägliches Budget, standardmäßig 50. Die Response-Header Test-Create-Limit, Test-Create-Remaining und Test-Create-Reset machen das aktuelle Budget sichtbar. Ein idempotent wiederholter Request verbraucht keinen weiteren Platz.

Testanträge und ihre antragsgebundenen Artefakte werden standardmäßig nach 30 Tagen bereinigt. Je Konfiguration kann die Frist zwischen 7 und 365 Tagen liegen. Diese Frist ist keine pauschale Löschzusage für eigenständige Test-Halter, Kennzeichenchecks oder Reservierungen. Verwenden Sie Testdaten deshalb nicht als dauerhaftes Archiv und sichern Sie benötigte Prüfergebnisse rechtzeitig in Ihrer eigenen Testumgebung.