Antragsbestellung abrufen

Bei Feinstaubplaketten kann next_action zunächst einen Fahrzeugschein- oder Emissionsnachweis verlangen. Erforderlich ist orders:read.

Beschreibung

Liefert Voraussetzungen, Preis-Snapshot und Versandstand einer Bestellung.

Parameter

idpathPflicht

Öffentliche Antrags-ID.

Beispiel: app_test_1a2b3c4d5e6f708192a3b4c5

order_idpathPflicht

Öffentliche Bestell-ID.

Beispiel: ord_test_5e6f708192a3b4c5d6e7f809

Responses

200

Aktuelle Bestellressource.

404

Antrag oder Bestellung fehlt beziehungsweise gehört zu einem anderen Mandanten.

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 Bestell-ID.
`object`	string	Immer	Konstanter Wert `order`.
`environment`	enum	Immer	`test` oder `live`.
`livemode`	boolean	Immer	`true` für Live-Ressourcen.
`application_id`	string	Immer	Zugehörige Antrags-ID.
`type`	enum	Immer	`license_plates` oder `emissions_sticker`.
`status`	enum	Immer	Aktueller Fulfillment-Status der Bestellung.
`items`	array	Immer	Gebundene Artikel- und Fulfillmentdaten.
`amount_total`	integer	Optional	Bruttobetrag in Euro-Cent.
`currency`	string	Immer	Dreistelliger ISO-Währungscode.
`next_action`	object	Optional	Noch erforderliche Clientaktion und Ziel-URL.
`tracking_code`	string	Optional	Versandverfolgungsnummer.
`delivered_at`	date-time	Optional	Zustellzeitpunkt.
`created_at, updated_at`	date-time	Immer	Erstellungs- und Änderungszeitpunkt.

{
  "id": "ord_test_5e6f708192a3b4c5d6e7f809",
  "object": "order",
  "environment": "test",
  "livemode": false,
  "application_id": "app_test_1a2b3c4d5e6f708192a3b4c5",
  "type": "emissions_sticker",
  "status": "pending",
  "items": [
    {
      "simulation": true
    }
  ],
  "currency": "EUR",
  "next_action": {
    "type": "upload_vehicle_document",
    "url": "/api/v1/applications/app_test_1a2b3c4d5e6f708192a3b4c5/orders/ord_test_5e6f708192a3b4c5d6e7f809/documents"
  },
  "created_at": "2026-08-26T10:24:00+02:00",
  "updated_at": "2026-08-26T10:24:00+02:00"
}

Feinstaubplakette bei Neuzulassung

Bei einer Neuzulassung ist der neue Fahrzeugschein häufig erst nach dem Zulassungsergebnis vorhanden. Eine Order mit status: pending und next_action.type: upload_vehicle_document ist deshalb kein technischer Fehler. Übertragen Sie den Nachweis erst, wenn das Dokument vorliegt.

Preis-Snapshot

amount_total enthält den Bruttobetrag in Euro-Cent, sobald er feststeht. Die Abrechnung folgt Ihrem Vertragsmodell. Die Public API startet keinen Endkunden-Checkout.

{ "id": "ord_test_5e6f708192a3b4c5d6e7f809", "object": "order", "environment": "test", "livemode": false, "application_id": "app_test_1a2b3c4d5e6f708192a3b4c5", "type": "emissions_sticker", "status": "pending", "items": [ { "simulation": true } ], "currency": "EUR", "next_action": { "type": "upload_vehicle_document", "url": "/api/v1/applications/app_test_1a2b3c4d5e6f708192a3b4c5/orders/ord_test_5e6f708192a3b4c5d6e7f809/documents" }, "created_at": "2026-08-26T10:24:00+02:00", "updated_at": "2026-08-26T10:24:00+02:00" }