Recherche

Rechercher un véhicule réel par VIN

GET/vin/{vin}

Décodez un VIN de 17 caractères en données de véhicule et obtenez des images studio de la voiture correspondante en un seul appel.

Add-on — doit être activé pour votre clé. Vérifiez features.vin dans /api/me. Sans cela, l'endpoint renvoie 403.

Ce que vous recevez en retour.

Le véhicule décodé: marque, modèle, année, finition, carrosserie, moteur, transmission, transmission.
Un bloc vehicle avec la voiture la plus proche de notre catalogue et une URL d'image signée par vue que votre plan autorise.

L'appariement est automatique: la marque/modèle/année/carrosserie décodée est mise en correspondance avec notre catalogue, en sélectionnant la génération qui couvre l'année du véhicule. Lisez vehicle.confidence pour voir à quel point la correspondance est proche, et vehicle.matched: false lorsqu'il n'existe rien de convenable — les données décodées sont toujours renvoyées dans ce cas.

Les VIN invalides sont rejetés avec 400 avant tout frais. Un VIN qui ne peut pas être décodé renvoie 404.

Paramètres de chemin

Nom	Type	Description
`vin` obligatoire	chaîne	Numéro d'identification du véhicule de 17 caractères (les lettres I, O et Q ne sont jamais utilisées).

Demande

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

200 · Véhicule décodé plus la voiture du catalogue correspondante et ses images.

{
  "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 · Le VIN n'est pas un VIN valide de 17 caractères. Rien n'est facturé.

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

403 · L'add-on VIN n'est pas activé pour votre clé.

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

404 · Aucune donnée n'a pu être trouvée pour ce VIN.

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

502 · Recherche temporairement indisponible, réessayez bientôt. Rien n'est facturé.

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