PKW Label API Docs

Achtung: veraltete API Definition – neue Dokumentation unter:
https://api.pkwlabel.com/docs
mit 5 neuen PKW Labels der Gesetzesnovelle 2024

PKW-Label Beispiel

Die EnVKV API bietet einen Dienst zur Berechnung der seit dem 01.12.2011 notwendigen Energieverbrauchswerte und Effizienzklassen Darstellung bei Neu-PKW Angeboten. Es besteht die Möglichkeit zur Rückgabe der berechneten Werte auf Grund von fahrzeugspezifischen Grundwerten, so wie die Erstellung einer DinA4 PKW Label PDF Datei.

PKW Label

Falls Sie nur einige wenige Verbrauchsdatenblätter erstellen müssen, empfehlen wir Ihnen die direkte Eingabe bei www.pkw-label.de. Die EnVKV API ist für eine automatisierte Berechnung zwischen Webseiten bzw. Apps ausgelegt.

REST

Die API verwendet die REST Architektur und liefert ihre Antworten im JSON Format aus bzw. im Fall des PKW Labels wird bei erfolgreicher Bearbeitung direkt ein PDF File on-the-fly erzeugt und dargestellt. Die Ausgabe kann dann vom anfragenden System entsprechend weiterverarbeitet bzw. die PDF Datei gespeichert werden.

Basis URL für Anfragen

https://envkv.54grad.de/api/

API Resources

Folgende Anfragen sind möglich.

POST pkwlabel	Erstellung des PKW Labels als DinA4 PDF, wenn alle EnVKV Werte vorhanden sind.
POST effizienzklasse	Ermittlung der CO2 Effizienzklasse. Einzelabfrage, sofern nicht data verwendet wird.
POST tax	Ermittlung der zu erwartenden KFZ Steuer im ersten Zulassungsjahr. Einzelabfrage, sofern nicht data verwendet wird.
GET energiekosten	Abfrage der derzeit im System unterstützten Kraftstoffe mit den vom Bundeswirtschaftsministerium zuletzt gemeldeten Durchschnittspreisen.
POST energiekosten	Ermittlung der Energieträgerkosten bei 20.000km Laufleistung. Einzelabfrage, sofern nicht data verwendet wird.
POST data	Zusammenfassende Berechnung der EnVKV Werte, welche die Abfragen effizienzklasse, tax und energiekosten in einer Abfrage ermöglicht.

Authentifizierung

Für die Nutzung der EnVKV API ist ein API Key notwendig. Bitte setzen Sie sich für weitere Informationen über das Kontaktformular mit uns in Verbindung.

Anfragen ohne API Key an vorhandene Resourcen werden mit einem 401 Authorization Required Header und einer JSON Statusmeldung beantwortet.

Antwort

{
    "statuscode":401,
    "status":"Authorization Required"
}

Client-Beispiele für die API Abfrage

In der Client-Beispiele Sammlung sehen Sie Möglichkeiten, wie die EnVKV API abgefragt werden kann.