Decode an international VIN when a vehicle is outside the standard US specification data set. The endpoint returns the decoded attributes that are available for the VIN, including make, model, year, body, manufacturer, plant country, drivetrain-related details, dimensions, and capacity fields when the source provides them.
Use this endpoint directly for non-US VIN workflows, or use the Specifications endpoint and leave disableIntVINDecoding unset so it can fall back to International VIN Decoding when a standard VIN decode has no result.
Parameters
| Parameter | Required | Description |
|---|---|---|
vin | Yes | The vehicle identification number to decode |
key | Yes | Your CarsXE API key |
Example
Decode an international VIN
Response
For the full interactive reference, try it live in the API Reference.
All response fields other than success and input are optional. International VIN coverage varies by manufacturer, market, and model year, so missing fields mean the decoding source did not provide that attribute for the VIN.
Top-level fields
- Name
success- Type
- boolean
- Description
truewhen the VIN was decoded successfully.
- Name
input- Type
- object
- Description
Echoes the VIN submitted in the request.
- Name
attributes- Type
- object
- Description
Decoded vehicle fields. Common fields include
vin,make,model,year,product_type,body,series,fuel_type,manufacturer,plant_country, dimensions, weights, brakes, suspension, and VIN metadata.
- Name
timestamp- Type
- string
- Description
ISO 8601 response time.
Common attribute groups
Identity — Core decoded vehicle identity
- Name
vin- Type
- string
- Description
The decoded vehicle identification number. Example:
"WF0MXXGBWM8R43240".
- Name
make- Type
- string
- Description
Manufacturer or brand. Example:
"Ford".
- Name
model- Type
- string
- Description
Model family. Example:
"Galaxy".
- Name
year- Type
- string
- Description
Model year when available. Example:
"2008".
- Name
product_type- Type
- string
- Description
Vehicle category such as
"Car"or"Truck".
- Name
body- Type
- string
- Description
Body classification such as
"Wagon"or"Pickup".
Manufacturer and plant — Builder and production details
- Name
manufacturer- Type
- string
- Description
Manufacturer name and address when supplied by the decoding source.
- Name
manufacturer_address- Type
- string
- Description
Manufacturer address when available separately.
- Name
plant_country- Type
- string
- Description
Country where the vehicle was built. Example:
"Germany".
- Name
engine_manufacturer- Type
- string
- Description
Engine manufacturer when available.
Technical data — Engine, dimensions, capacity, and VIN metadata
- Name
fuel_type- Type
- string
- Description
Fuel type such as
"Diesel"or"Gasoline".
- Name
gears- Type
- string
- Description
Transmission gear count when decoded.
- Name
wheelbase_mm- Type
- string
- Description
Wheelbase in millimeters when available.
- Name
height_mm- Type
- string
- Description
Vehicle height in millimeters when available.
- Name
length_mm- Type
- string
- Description
Vehicle length in millimeters when available.
- Name
width_mm- Type
- string
- Description
Vehicle width in millimeters when available.
- Name
check_digit- Type
- string
- Description
VIN check digit.
- Name
sequential_number- Type
- string
- Description
VIN sequential production number segment.