Skip to content

VIN Vehicle Check

The VIN Vehicle Check lets you decode a Vehicle Identification Number (VIN) and retrieve standardised vehicle specifications — make, model, year, body type, engine, and more — using the Octamile AIMS API.

Activation required

This service is disabled by default. Contact support@octamile.com to activate it on your account. There is no per-call charge.

Overview

Property Value
Endpoint POST https://octamile-api.azurewebsites.net
Auth Partner credentials (userInfo.id + userInfo.athrzt)
Command enrch vin_vehicle
Response time ~1–2 seconds
Coverage Vehicles registered or manufactured for international markets

Request

curl -X POST https://octamile-api.azurewebsites.net \
  -H "Content-Type: application/json" \
  -d '{
    "userInfo": {
      "id": "your-partner-uuid",
      "athrzt": {
        "id": "your-auth-id",
        "key": "your-api-key"
      }
    },
    "cmmnd": {
      "cmmnd": "enrch vin_vehicle",
      "seed": {
        "vin": "4T1BF1FK5HU271505"
      }
    }
  }'

import requests

res = requests.post(
    "https://octamile-api.azurewebsites.net",
    json={
        "userInfo": {
            "id": "your-partner-uuid",
            "athrzt": {"id": "your-auth-id", "key": "your-api-key"},
        },
        "cmmnd": {
            "cmmnd": "enrch vin_vehicle",
            "seed": {"vin": "4T1BF1FK5HU271505"},
        },
    },
    timeout=15,
)
data = res.json()

const res = await fetch("https://octamile-api.azurewebsites.net", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    userInfo: {
      id: "your-partner-uuid",
      athrzt: { id: "your-auth-id", key: "your-api-key" },
    },
    cmmnd: {
      cmmnd: "enrch vin_vehicle",
      seed: { vin: "4T1BF1FK5HU271505" },
    },
  }),
});
const data = await res.json();

Request fields

Field Type Required Description
seed.vin string Yes 17-character Vehicle Identification Number. Must be alphanumeric; letters I, O, and Q are not valid VIN characters.

Responses

Decode successful

{
  "make": "TOYOTA",
  "model": "Camry",
  "year": "2017",
  "bodyClass": "Sedan/Saloon",
  "engineDisplacement": "2.5",
  "fuelType": "Gasoline",
  "manufacturer": "Toyota Motor Manufacturing, Kentucky, Inc.",
  "plantCountry": "United States (USA)",
  "vehicleType": "PASSENGER CAR",
  "exctnFdbck": { "id": 75, "id_v4": 200 }
}

Sparse result

Some vehicles return only a subset of fields — for example, make and model year but not engine displacement. This is normal for vehicles manufactured primarily for certain regional markets. Your integration should treat all spec fields as optional.

{
  "make": "HONDA",
  "model": "Accord",
  "year": "2020",
  "exctnFdbck": { "id": 75, "id_v4": 200 }
}

Response fields

Field Type Description
make string Vehicle manufacturer brand (e.g. "TOYOTA")
model string Model name (e.g. "Camry")
year string Model year (e.g. "2017")
bodyClass string Body style (e.g. "Sedan/Saloon", "SUV", "Pick-up Truck")
engineDisplacement string Engine size in litres (e.g. "2.5")
fuelType string Primary fuel type (e.g. "Gasoline", "Diesel", "Electric")
manufacturer string Full legal manufacturer name
plantCountry string Country where the vehicle was assembled
vehicleType string High-level classification (e.g. "PASSENGER CAR", "MULTIPURPOSE PASSENGER VEHICLE (MPV)")

All fields are optional in the response — check for their presence before using them.

Error responses

exctnFdbck.id_v4 Meaning
403 Service not activated on your account. Contact support@octamile.com to enable it.
400 Missing or invalid seed.vin — must be exactly 17 alphanumeric characters (no I, O, or Q).
502 Specification lookup unavailable. Retry the request.

Billing

VIN Vehicle Check is currently provided at no charge. Usage is logged and visible in the Services section of your dashboard.