Suche

Ein reales Fahrzeug nach VIN suchen

Holen/vin/{vin}

Decodieren Sie eine 17-stellige VIN in Fahrzeugdaten und erhalten Sie Studiobilder des passenden Autos in einem Aufruf.

Add-on — muss für Ihren Schlüssel aktiviert sein. Prüfen Sie features.vin unter /api/me. Ohne diese Funktion gibt der Endpunkt 403 zurück.

Was Sie zurückbekommen

Das decodierte Fahrzeug: Marke, Modell, Jahr, Ausstattung, Karosserie, Motor, Getriebe, Antrieb.
Ein vehicle Block mit dem nächstgelegenen Auto aus unserem Katalog und einer signierten Bild-URL pro Ansicht, die Ihr Plan erlaubt.

Matching ist automatisch: das decodierte Modell/Jahr/Karosserie wird auf unseren Katalog abgebildet, wobei die Generation ausgewählt wird, die das Fahrzeugjahr abdeckt. Lesen Sie vehicle.confidence, um zu sehen, wie genau die Übereinstimmung ist, und vehicle.matched: false, wenn nichts Passendes existiert. Die decodierten Daten werden in diesem Fall dennoch zurückgegeben.

Ungültige VINs werden mit 400 abgelehnt, bevor etwas berechnet wird. Eine VIN, die nicht dekodiert werden kann, gibt 404 zurück.

Pfadparameter

Name	Typ	Beschreibung
`vin` erforderlich	Zeichenkette	17-stellige Fahrzeug-Identifikationsnummer (die Buchstaben I, O und Q werden nie verwendet).

Anfragen

curl "https://api.vehicleimagery.com/vin/vin" \
  -H "x-api-key: YOUR_API_KEY"

200 · Decodiertes Fahrzeug plus das passende Katalogfahrzeug und dessen Bilder.

{
  "vin": "WBA8E9G50GNT47251",
  "make": "BMW",
  "model": "3 Series",
  "year": 2016,
  "trim": "328i",
  "body": "Sedan",
  "engine": {
    "name": "328i",
    "cylinders": 4,
    "displacement_ccm": 1997,
    "horsepower": 240,
    "fuel": "premium unleaded",
    "configuration": "inline"
  },
  "transmission": "AUTOMATIC",
  "drivetrain": "rear wheel drive",
  "doors": "4",
  "vehicle": {
    "matched": true,
    "confidence": "high",
    "id": 993477403,
    "brand": "BMW",
    "model": "3",
    "year": 2012,
    "variant": "Basis",
    "trim": "base",
    "color": "default",
    "images": {
      "front": "https://cdn.vehicleimagery.com/…",
      "front_left": "https://cdn.vehicleimagery.com/…"
    }
  }
}

400 · Die VIN ist keine gültige 17-stellige VIN. Es werden keine Kosten erhoben.

{
  "error": "Invalid VIN — expected 17 characters (letters I, O, Q are not used)."
}

403 · Das VIN-Add-on ist für Ihren Schlüssel nicht aktiviert.

{
  "error": "The vin add-on is not enabled for your API key."
}

404 · Für diese VIN konnten keine Daten gefunden werden.

{
  "error": "No data found for this VIN.",
  "vin": "WBA8E9G50GNT47251"
}

502 · Abfrage vorübergehend nicht verfügbar. Bitte versuchen Sie es später erneut. Es werden keine Kosten erhoben.

{
  "error": "VIN lookup temporarily unavailable."
}