Consulta

Consulte um veículo real pelo VIN

GET/vin/{vin}

Decodifique um VIN de 17 caracteres em dados do veículo e obtenha imagens de estúdio do carro correspondente em uma única chamada.

Add-on — deve estar habilitado para sua chave. Verifique features.vin em /api/me. Sem ele, o endpoint retorna 403.

O que você recebe de volta

O veículo decodificado — marca, modelo, ano, versão, carroceria, motor, transmissão, tração.
Um bloco vehicle com o carro mais próximo do nosso catálogo e uma URL de imagem assinada por vista que seu plano permite.

A correspondência é automática: a marca/modelo/ano/carroceria decodificada é mapeada em nosso catálogo, selecionando a geração que cobre o ano do veículo. Leia vehicle.confidence para ver o quão próxima é a correspondência, e vehicle.matched: false quando nada adequado existe — os dados decodificados ainda são retornados nesse caso.

VINs inválidos são rejeitados com 400 antes que qualquer coisa seja cobrada. Um VIN que não pode ser decodificado retorna 404.

Parâmetros de caminho

Nome	Tipo	Descrição
`vin` obrigatório	string	Número de Identificação do Veículo de 17 caracteres (as letras I, O e Q nunca são usadas).

Solicitar

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

200 · Veículo decodificado mais o carro do catálogo correspondente e suas imagens.

{
  "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 · O VIN não é um VIN válido de 17 caracteres. Nada é cobrado.

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

403 · O add-on de VIN não está ativado para sua chave.

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

404 · Nenhum dado encontrado para este VIN.

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

502 · Consulta temporariamente indisponível, tente novamente em breve. Nada é cobrado.

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