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.
Oder per E-Mail: hello@servicestamp.de
curl -G "https://api.servicestamp.de/v1/service-history" \
-d vin=WVWZZZAUZKW417306 \
-H "x-api-key: YOUR_API_KEY"
{
"success": true,
"result": {
"vehicle_identification_number": "WVWZZZAUZKW417306",
"service_events": [
{
"date_of_service_event": "2024-09-12",
"service_provider": "Volkswagen Vertragshändler",
"mileage_observed": 72300,
"mileage_unit": "km"
}
]
}
}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.
Prüfen Sie jede Inzahlungnahme schon bei der Bewertung: Die Serviceeinträge landen automatisch in Ihrem DMS oder Ihrer Bestandsverwaltung.
Zeigen Sie die verifizierte Servicehistorie auf Ihren Fahrzeugseiten: die Anzahl der Inspektionen beim Vertragshändler, das Datum der letzten Inspektion und den Kilometerstand.
Ergänzen Sie die Seite jedes Loses um die Servicehistorie des Herstellers, damit Käufer sie sehen, bevor die Gebotsphase beginnt.
Prüfen Sie am Vertragsende die Wartung aller Rückläufer in einem Durchgang, ohne jedes Fahrzeug einzeln einzutippen.
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.
Eine authentifizierte Anfrage pro Fahrzeug, mit Ihrem Schlüssel im Header x-api-key.
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.
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" }
]
}
]
}
}| Feld | Bedeutung |
|---|---|
| date_of_service_event | Wann die Inspektion durchgeführt wurde |
| service_provider | Der Vertragshändler, der die Arbeiten ausgeführt hat |
| mileage_observed / mileage_unit | Kilometerstand beim Werkstattbesuch, in km oder mi |
| service_type | Die Art des Werkstattbesuchs |
| service_items | Jede durchgeführte Arbeit, mit ihrer Kategorie |
| report_url | Der 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.
Berechnet wird nur, wenn Serviceeinträge zurückkommen.
| Code | Bedeutung |
|---|---|
| 200 | Serviceeinträge gefunden. 3,99 € werden von Ihrem API-Guthaben abgebucht, oder 2,99 € mit dem Monatstarif. |
| 202 | Das Herstellersystem arbeitet noch. Versuchen Sie es nach der im Header Retry-After angegebenen Zeit erneut. Berechnet wird erst, wenn Serviceeinträge zurückkommen. |
| 204 | Keine Hersteller-Serviceeinträge zu diesem Fahrzeug. Wird nicht berechnet. |
| 400 | Ungültige FIN. |
| 401 | Der API-Schlüssel fehlt, ist ungültig oder gesperrt. |
| 402 | Ihr API-Guthaben ist aufgebraucht. Laden Sie es in Ihrem Händler-Dashboard auf. |
| 403 | Der API-Zugang ist abgeschaltet oder das Händlerkonto ist nicht aktiv. |
| 404 | Zu dieser FIN wurde kein Fahrzeug gefunden. Wird nicht berechnet. |
| 429 | Zu viele Anfragen. Drosseln Sie das Tempo und versuchen Sie es nach der im Header Retry-After angegebenen Zeit erneut. |
| 503 | Die Abfrage konnte auf unserer Seite nicht abgeschlossen werden. Versuchen Sie es später erneut. Wird nicht berechnet. |
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.
| Position | Preis |
|---|---|
| Abfrage mit Serviceeinträgen, Abrechnung pro Abfrage | 3,99 € |
| Monatstarif der API (optional) | 59,99 € pro Monat |
| Abfrage mit Serviceeinträgen, mit dem Monatstarif | 2,99 € |
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.
Eine Antwort „wird noch verarbeitet“ wird nie berechnet. Fragen Sie erneut ab, sobald das Ergebnis bereitsteht, und Sie zahlen nur einmal.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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
Berichte zum festen Händlerpreis ab 4,99 €, dazu persönlicher Support und ein Team-Dashboard.