Búsqueda

Buscar un vehículo real por VIN

OBTENER/vin/{vin}

Decodifica un VIN de 17 caracteres en datos del vehículo y obtén imágenes de estudio del auto correspondiente en una sola llamada.

Add-on — debe estar habilitado para tu clave. Revisa features.vin en /api/me; sin él, el punto final devuelve 403.

Lo que obtienes

El vehículo decodificado: marca, modelo, año, acabado, carrocería, motor, transmisión y tren motriz.
Un bloque de vehicle con el coche más cercano de nuestro catálogo y una URL de imagen firmada por vista que permita su plan.

La coincidencia es automática: la marca/modelo/año/carrocería decodificada se mapea en nuestro catálogo, seleccionando la generación que cubre el año del vehículo. Lea vehicle.confidence para ver qué tan cercana es la coincidencia, y vehicle.matched: false cuando no existe nada adecuado — los datos decodificados aún se devuelven en ese caso.

Los VIN inválidos son rechazados con 400 antes de que se cobre algo. Un VIN que no se puede decodificar devuelve 404

Parámetros de ruta

Nombre	Tipo	Descripción
`vin` requerido	cadena	Número de Identificación Vehicular de 17 caracteres (las letras I, O y Q nunca se usan).

Solicitud

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

200 · Vehículo decodificado más el auto del catálogo coincidente y sus imágenes.

{
  "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 · El VIN no es un VIN válido de 17 caracteres. No se cobra nada.

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

403 · El complemento de VIN no está habilitado para su clave.

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

404 · No se encontraron datos para este VIN.

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

502 · La búsqueda no está disponible temporalmente — inténtelo de nuevo en breve. No se cobra nada.

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