Búsqueda

Buscar un vehículo real por VIN (Beta)

OBTENER/vin/{vin}

> Beta. Este endpoint está en vivo y es utilizable, pero aún está evolucionando: los campos de respuesta pueden cambiar, y la cobertura de decodificación y la coincidencia del catálogo se están mejorando. Se agradece la retroalimentación. Por favor, no construya nada crítico para la misión en la forma exacta de la respuesta aún.

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.

Adicional: debe estar habilitado para tu clave. Verifica features.vin en /api/me; sin él, el punto final devuelve 403.

Lo que obtienes

El vehículo, marca, modelo, año, acabado, carrocería, motor, transmisión y tren motriz decodificados.
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.

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. Consulte 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 · Consulta temporalmente no disponible, vuelva a intentarlo en breve. No se cobra nada.

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