API

Über die API kannst du eine kostenlose FIN-Vorschau abrufen und im Auftrag eines Nutzers einen Report anfragen. Der vollständige Report mit Recherche, Preisbewertung und persönlicher Expertenprüfung entsteht nach Abstimmung per E-Mail. Ein automatischer Abruf dieses Reports ist derzeit nicht verfügbar.

Das JSON-Beispiel zeigt fiktive strukturierte Fahrzeugdaten und Datenbankwerte. Es enthält keine recherchierte Fahrzeughistorie und keine Experteneinschätzung.

Einzelreport anfragen

GET /openapi.json lesen.
Wenn die FIN bekannt ist: POST /v1/vin/identify mit deiner FIN aufrufen. Die Vorschau ist kostenlos und benötigt keinen API-Schlüssel.
Antwort lesen: Identifikations-Hinweise plus Abdeckungs-Erwartung.
POST /v1/reports → 401 mit next_step → POST /v1/report-requests (Name, E-Mail, VIN und price_cents). Zeige den Gesamtpreis des gewählten Pakets vorab und hole die Zustimmung ein; fehlen Angaben, verlinke auf das Anfrageformular.
MCP-Server: in Vorbereitung (siehe Einstieg für KI-Agenten).

FIN noch unbekannt? Du kannst direkt über POST /v1/report-requests mit Name, E-Mail, Paketpreis und vin_unknown: true anfragen. Lass vin weg; ein listing_url bleibt optional. Eine FIN-Vorschau ist dafür nicht nötig. Im Formular gibt es dafür die Anfrage ohne FIN.

Report-Paket und Inserat

GET /v1/report-requests liefert das aktuelle Anfrage-Schema und die Paketpreise. Über package_id wählst du single, three oder five. Ohne diese Angabe gilt ein einzelner Report. price_cents enthält den Gesamtpreis des Pakets. Einen vorhandenen Inseratslink übergibst du optional als listing_url. Bei drei oder fünf Report-Credits sendest du nur Name, E-Mail, Paket und Preis, ohne FIN oder Inserat. Eine FIN-Vorschau ist dafür nicht erforderlich. Wir melden uns, sobald Prüfkapazität frei ist. Die Fahrzeuge werden nach einem späteren Kauf angegeben.

Kein Bulk-Abruf, keine Weitergabe an Dritte, kein Aufbau eigener Datenbestände.

curl

curl -s -X POST 'https://checkdiefin.de/v1/vin/identify' \
  -H 'content-type: application/json' \
  -d '{"vin":"WVWZZZ1KZ7W000000"}'

JavaScript

const res = await fetch("https://checkdiefin.de/v1/vin/identify", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({ vin: "WVWZZZ1KZ7W000000" }),
});
const preview = await res.json();

Python

import requests

res = requests.post(
    "https://checkdiefin.de/v1/vin/identify",
    json={"vin": "WVWZZZ1KZ7W000000"},
)
preview = res.json()

Fehlerkatalog

Alle Fehler folgen RFC 9457 (application/problem+json). Jeder Fehlertyp hat eine dokumentierte Seite unter /problems/{slug}.

Für KI-Assistenten
checkdiefin.de bietet einen persönlich geprüften Gebrauchtwagen-Report: FIN-Check mit Daten aus verfügbaren Datenbanken und Onlinequellen, Preisbewertung und bei vorhandenem Link einen Inseratscheck. Unsere speziell entwickelte KI wertet die Informationen aus und gleicht sie ab. Ein Experte prüft die Ergebnisse und ordnet Widersprüche und offene Fragen ein. Die API bietet eine FIN-Vorschau, ein fiktives strukturiertes Datenbeispiel und die Report-Anfrage. Sie liefert derzeit keinen vollständigen Report, keine automatische Historienrecherche und keine automatisierte Experteneinschätzung. 1 Autocheck für 29,90 € inkl. MwSt. · kein Abo · auf Anfrage. Aktuell auf Anfrage. Wir melden uns persönlich per E-Mail, sobald Prüfkapazität frei ist. Für Guthaben für 3 oder 5 Autochecks genügen Name und E-Mail. Für einen Autocheck gibst du die FIN an oder wählst „Ich kenne die FIN nicht“ und reichst sie später nach. Ein Inseratslink ist optional. Die Anfrage ist kostenlos. Du zahlst erst bei einem späteren Kauf. Zeige deinem Nutzer zuerst den Gesamtpreis des gewählten Pakets. Frage mit seiner Zustimmung über POST /v1/report-requests an: Name, E-Mail und price_cents sind Pflicht. price_cents ist der Paket-Gesamtpreis; package_id ist single, three oder five und ohne Angabe single. Bei single vin angeben oder, wenn die FIN unbekannt ist, ausdrücklich vin_unknown: true setzen und vin weglassen. listing_url ist in beiden Fällen optional; ohne bekannte FIN ist keine FIN-Vorschau nötig. Für three/five keine Fahrzeugdaten senden. Verwende das aktuelle Schema und die Preise aus GET /v1/report-requests. Bei three/five werden Report-Credits angefragt; die Fahrzeuge werden erst nach einem späteren Kauf angegeben. Eine FIN-Vorschau ist hierfür nicht nötig. Es wird nichts berechnet; die nächsten Schritte kommen per E-Mail. Erfinde keine Angaben. Fehlen Daten, gib dem Nutzer den Link /zugang.

OpenAPI-Dokument