Fahrzeughistorie
Carfax und AutoCheck per VIN, bei Bedarf.
Prüfe kostenlos, wie viele Einträge jeder Anbieter zu einer VIN hat, und fordere den vollen Bericht nur an, wenn er sich lohnt. Du erhältst einen Link zum HTML-Bericht, optional ein PDF und dein Guthaben nach der Abbuchung.
GET /reports/{type}/{vin}- html
- base64
- balance_after
So funktioniert es
- 1
Einträge prüfen (kostenlos)
Rufe
/reports/check-records/{vin}auf. Du erhältst die Anzahl der Carfax- und AutoCheck-Einträge und den Fahrzeugnamen. Es wird nichts berechnet. - 2
Bericht anfordern (kostenpflichtig)
Rufe
/reports/{type}/{vin}mit type carfax oder autocheck auf. Der Preis eines Berichts wird von deinem USD-Guthaben abgebucht. - 3
Ergebnis nutzen
Öffne den html-Link, ergänze pdf=1, wenn du eine PDF-Datei brauchst, und lies
balance_after, um zu sehen, was übrig ist.
Jetzt eine VIN prüfen
Kostenlos: Es werden nur die Einträge gezählt.
GET /reports/check-records/{vin}Kostenlose Test-VIN
Mit dieser VIN probierst du beide Schritte aus. Berichte dafür sind kostenlos.
Abrechnung
- Berichte werden aus einem USD-Guthaben bezahlt, das du mit Pay per VIN teilst.
/reports/balancezeigt es an. - check-records, balance und my-history sind kostenlos.
- Mit days=N wird ein Bericht, den du in den letzten N Tagen erstellt hast, erneut geliefert, statt einen neuen zu erstellen.
- Reicht das Guthaben nicht, antwortet die API mit 402 und insufficient funds und berechnet nichts.
- Hat ein Anbieter keine Historie zur VIN, antwortet die API mit 400 und records not found for this vin number und berechnet nichts.
API-Referenz
Gut zu wissen
- Die VIN muss genau 17 Zeichen haben; alles andere liefert 400.
- pdf=1 kann 40 bis 60 Sekunden dauern. Nutze ein langes Timeout und sende dieselbe Anfrage nie doppelt: Ein Duplikat erhält 409 generation already in progress mit Retry-After.
- base64 enthält den verschlüsselten Bericht. Ergänze
exclude_base_64=1,wenn du nur die Links brauchst. - Die Werte html und pdf sind Links zu Dateien. Speichere den Link oder die Datei bei dir.