Servicehistorie-API für Autohäuser und Händler

Führen Sie Scheckheft-Prüfungen direkt aus Ihren eigenen Systemen durch. Senden Sie eine FIN und erhalten Sie die Serviceeinträge aus dem Vertragshändlernetz des Herstellers als strukturiertes JSON zurück. 3,99 € pro Abfrage mit Serviceeinträgen oder 2,99 € mit dem Monatstarif für 59,99 € pro Monat.

  • Abfrage per FIN
  • Vertragshändler-Serviceeinträge für 38 Marken
  • 3,99 € pro Abfrage mit Serviceeinträgen, aus vorab aufgeladenem Guthaben; 2,99 € mit dem Monatstarif
  • Keine Serviceeinträge, keine Kosten
4,9 von verifizierten Käufern

Was Sie damit umsetzen können

Bringen Sie die Servicehistorie des Herstellers dorthin, wo Ihr Team und Ihre Käufer ohnehin hinsehen, ohne dass jemand Prüfungen von Hand durchführt.

Fahrzeugankauf und DMS

Prüfen Sie jede Inzahlungnahme schon bei der Bewertung: Die Serviceeinträge landen automatisch in Ihrem DMS oder Ihrer Bestandsverwaltung.

Website und Inserate

Zeigen Sie die verifizierte Servicehistorie auf Ihren Fahrzeugseiten: die Anzahl der Inspektionen beim Vertragshändler, das Datum der letzten Inspektion und den Kilometerstand.

Auktions- und Remarketing-Plattformen

Ergänzen Sie die Seite jedes Loses um die Servicehistorie des Herstellers, damit Käufer sie sehen, bevor die Gebotsphase beginnt.

Flotten- und Leasingrückläufer

Prüfen Sie am Vertragsende die Wartung aller Rückläufer in einem Durchgang, ohne jedes Fahrzeug einzeln einzutippen.

So funktioniert's

  1. API-Schlüssel erhalten

    Der API-Zugang gehört zu einem freigeschalteten Händlerkonto. Sprechen Sie uns an, und wir schalten ihn frei. Danach laden Sie Guthaben auf und erstellen Ihre Schlüssel in Ihrem Händler-Dashboard. Der Monatstarif ist optional.

  2. FIN senden

    Eine authentifizierte Anfrage pro Fahrzeug, mit Ihrem Schlüssel im Header x-api-key.

  3. Strukturierte Serviceeinträge erhalten

    Jede Inspektion beim Vertragshändler kommt mit ihrem Datum, dem Kilometerstand, dem ausführenden Vertragshändler und den durchgeführten Arbeiten zurück, dazu ein Link zum vollständigen ServiceStamp-Bericht.

Beispiel für Anfrage und Antwort

Eine Anfrage pro Fahrzeug. Jede Inspektion beim Vertragshändler, die beim Hersteller erfasst ist, kommt in service_events zurück.

Basis-URL: https://api.servicestamp.de/v1. Dieselben Endpunkte antworten auch unter https://servicestamp.de/api/v1.

Anfrage

curl -G "https://api.servicestamp.de/v1/service-history" \
  -d vin=WVWZZZAUZKW417306 \
  -H "x-api-key: YOUR_API_KEY"

Antwort

{
  "success": true,
  "result": {
    "report_id": "rpt_8Kq2vX",
    "report_url": "https://servicestamp.de/report/rpt_8Kq2vX",
    "vehicle_identification_number": "WVWZZZAUZKW417306",
    "registration_mark": null,
    "vehicle": { "make": "Volkswagen", "model": "Golf (VII)", "year": 2019, "fuel_type": "Petrol" },
    "service_events": [
      {
        "date_of_service_event": "2024-09-12",
        "service_provider": "Volkswagen Vertragshändler",
        "mileage_observed": 72300,
        "mileage_unit": "km",
        "service_type": "serviceVisit",
        "service_items": [
          { "item_type": "Service", "item_description": "Motoröl und Ölfilter gewechselt" },
          { "item_type": "Inspection", "item_description": "Mehrpunkt-Sicherheitsinspektion durchgeführt" }
        ]
      }
    ]
  }
}

Was jeder Serviceeintrag enthält

FeldBedeutung
date_of_service_eventWann die Inspektion durchgeführt wurde
service_providerDer Vertragshändler, der die Arbeiten ausgeführt hat
mileage_observed / mileage_unitKilometerstand beim Werkstattbesuch, in km oder mi
service_typeDie Art des Werkstattbesuchs
service_itemsJede durchgeführte Arbeit, mit ihrer Kategorie
report_urlDer vollständige ServiceStamp-Bericht mit dem Kilometerverlauf, zum Teilen mit Käufern oder zum Herunterladen als PDF

Ein Wert, den wir nicht haben, kommt als null zurück und fehlt nie: Manche Hersteller senden keine Einheit zum Kilometerstand und keine Kategorie der Arbeit.

Antwortcodes

Berechnet wird nur, wenn Serviceeinträge zurückkommen.

CodeBedeutung
200Serviceeinträge gefunden. 3,99 € werden von Ihrem API-Guthaben abgebucht, oder 2,99 € mit dem Monatstarif.
202Das Herstellersystem arbeitet noch. Versuchen Sie es nach der im Header Retry-After angegebenen Zeit erneut. Berechnet wird erst, wenn Serviceeinträge zurückkommen.
204Keine Hersteller-Serviceeinträge zu diesem Fahrzeug. Wird nicht berechnet.
400Ungültige FIN.
401Der API-Schlüssel fehlt, ist ungültig oder gesperrt.
402Ihr API-Guthaben ist aufgebraucht. Laden Sie es in Ihrem Händler-Dashboard auf.
403Der API-Zugang ist abgeschaltet oder das Händlerkonto ist nicht aktiv.
404Zu dieser FIN wurde kein Fahrzeug gefunden. Wird nicht berechnet.
429Zu viele Anfragen. Drosseln Sie das Tempo und versuchen Sie es nach der im Header Retry-After angegebenen Zeit erneut.
503Die Abfrage konnte auf unserer Seite nicht abgeschlossen werden. Versuchen Sie es später erneut. Wird nicht berechnet.

Preise: Abrechnung pro Abfrage, günstiger mit dem Monatstarif

Abfragen werden von einem vorab aufgeladenen Guthaben abgebucht, zu je 3,99 € und nur, wenn Serviceeinträge zurückkommen. Der optionale Monatstarif für 59,99 € pro Monat senkt diesen Preis auf 2,99 €, rechnet sich ab 60 Abfragen pro Monat und ist jederzeit kündbar. Laden Sie Ihr Guthaben ab 50,00 € per Karte in Ihrem Dashboard auf.

PositionPreis
Abfrage mit Serviceeinträgen, Abrechnung pro Abfrage3,99 €
Monatstarif der API (optional)59,99 € pro Monat
Abfrage mit Serviceeinträgen, mit dem Monatstarif2,99 €

Keine Serviceeinträge, keine Kosten

Eine Abfrage, die keine Hersteller-Serviceeinträge findet, kostet nichts, genau wie bei den Prüfungen, die Sie als Händler im Dashboard durchführen.

Wiederholungen sind kostenlos

Eine Antwort „wird noch verarbeitet“ wird nie berechnet. Fragen Sie erneut ab, sobald das Ergebnis bereitsteht, und Sie zahlen nur einmal.

Was abgedeckt ist

Die API liefert Serviceeinträge aus dem Vertragshändlernetz der Hersteller für 38 Marken, für Fahrzeuge ab Modelljahr 2012. Wie detailliert ein Eintrag ist, hängt vom Hersteller ab.

Die Einträge stammen aus den Herstellersystemen und zeigen daher die Wartung bei Vertragshändlern. Arbeiten außerhalb des Vertragshändlernetzes sind in diesen Systemen nicht gespeichert. Die Abdeckung jeder einzelnen Marke finden Sie in der Markenübersicht.

Häufige Fragen zur Servicehistorie-API

Wer kann die Servicehistorie-API nutzen?

Der API-Zugang steht freigeschalteten ServiceStamp-Händlerkonten offen. Erzählen Sie uns, was Sie entwickeln, und wir schalten ihn frei. Danach laden Sie Guthaben auf und erstellen und verwalten Ihre eigenen Live- und Test-Schlüssel in Ihrem Händler-Dashboard. Der Monatstarif ist optional: Er senkt den Preis pro Abfrage.

Brauche ich die FIN?

Ja. Senden Sie die 17-stellige FIN. Die API sucht ein Fahrzeug nicht über sein Kennzeichen, mit dem Kennzeichen allein ist also keine Abfrage möglich.

Wie schnell kommen die Ergebnisse zurück?

Abfragen sind in der Regel mit einem einzigen Aufruf abgeschlossen. Braucht ein Herstellersystem länger, erhalten Sie eine Antwort 202 mit dem Header Retry-After. Fragen Sie nach dieser Zeit erneut ab: Ihr Aufruf fragt den Hersteller noch einmal, das kann einige Sekunden dauern, und berechnet wird nur einmal.

Was kostet die API?

3,99 € für jede Abfrage mit Serviceeinträgen, abgebucht von einem Guthaben, das Sie in Ihrem Händler-Dashboard per Karte aufladen (50,00 € bis 10.000,00 € pro Aufladung). Der optionale Monatstarif kostet 59,99 € pro Monat und Händlerkonto und senkt jede Abfrage auf 2,99 €, er rechnet sich also ab 60 Abfragen pro Monat. Eine Abfrage, die keine Hersteller-Serviceeinträge findet, kostet nichts, und dasselbe Fahrzeug innerhalb von 24 Stunden erneut abzufragen ist kostenlos. Sie können den Monatstarif jederzeit kündigen; er läuft bis zum Ende des Monats, den Sie bereits bezahlt haben.

Was passiert, wenn mein Guthaben aufgebraucht ist?

Live-Abfragen antworten mit 402, bis Sie Guthaben aufladen. Wir schreiben Ihnen per E-Mail, wenn das Guthaben unter 50,00 € fällt, und erneut, wenn eine Abfrage abgelehnt wird. Test-Schlüssel funktionieren weiter.

Was, wenn ich dasselbe Fahrzeug zweimal abfrage?

Eine zweite Abfrage desselben Fahrzeugs von Ihrem Konto innerhalb von 24 Stunden liefert den Bericht, den Sie bereits haben, und wird nicht berechnet. Deshalb wird auch eine Wiederholung nach einer Antwort 202 nie doppelt berechnet.

Gibt es eine Testumgebung (Sandbox)?

Ja. Fragen Sie nach einem Test-Schlüssel (er beginnt mit ss_test_). Er liefert für jede gültige FIN einen Musterbericht, belastet nie Ihr Guthaben und kontaktiert nie die Herstellersysteme. Die FIN TEST0000000000204 liefert die Antwort „keine Serviceeinträge“ und TEST0000000000202 die Antwort „wird noch verarbeitet“, sodass Sie jeden Fall vorbereiten können, bevor Sie live gehen.

Gibt es ein Limit für Anfragen?

Ja, standardmäßig 60 Anfragen pro Minute und Konto, gemeinsam für alle Ihre Schlüssel. Jede Antwort enthält die Header X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset. Wenn Sie mehr brauchen, sagen Sie uns Bescheid.

Prüft die API Finanzierung, Unfallschäden oder Diebstahl?

Nein. Die API deckt die Scheckheft-Prüfung ab: die Serviceeinträge aus dem Vertragshändlernetz, die der Hersteller zu einer FIN gespeichert hat. Unfall-, Finanzierungs- oder Diebstahl-Daten enthält sie nicht.

Erscheinen API-Abfragen in meinem Händler-Dashboard?

Ja. Jede Abfrage erscheint in Ihrem Händler-Dashboard neben den Prüfungen, die Sie dort durchführen, sodass Ihr gesamtes Team sie sehen kann.

Kann ich die Ergebnisse mit Käufern teilen?

Ja. Jede Antwort enthält eine report_url zum vollständigen ServiceStamp-Bericht, den Sie mit einem Käufer teilen oder als PDF herunterladen können.

Bereit, Ihre Systeme anzubinden?

Erzählen Sie uns, was Sie entwickeln und wie viele Fahrzeuge Sie ungefähr pro Monat prüfen, und wir richten alles für Sie ein.

Oder per E-Mail: hello@servicestamp.de

Kaufen oder verkaufen Sie Fahrzeuge in größeren Stückzahlen?

Berichte zum festen Händlerpreis ab 4,99 €, dazu persönlicher Support und ein Team-Dashboard.

Händlerkonto beantragen