International VIN Decoder API

The International VIN Decoder API provides access to a library of vehicle's data based on the vehicle's VIN. Start leveraging the power of CarsXE to access accurate and up-to-date vehicle data.

The International VIN Decoder API looks up the vehicle through the database for matches and returns the VIN, make, model and year among other attributes. It can be coupled with other APIs to become even more powerful.

This endpoint allows you to retrieve vehicle information based on VIN.

Required attributes

Name
key
Type
string
Description
Your CarsXE API key.
Name
vin
Type
string
Description
The 17 character long vehicle identification number.

Response Attributes

Name
success
Type
boolean
Description
Indicates whether the request was successful (e.g., true or false).
Name
input
Type
object
Description
Contains the input parameters used in the request.
- Name
  vin
  Type
  string
  Description
  The Vehicle Identification Number (VIN) (e.g., "WF0MXXGBWM8R43240").
Name
make
Type
string
Description
The vehicle manufacturer (e.g., "Ford").
Name
model
Type
string
Description
The vehicle model (e.g., "Galaxy").
Name
year
Type
string
Description
The manufacturing year of the vehicle (e.g., "2008").
Name
product_type
Type
string
Description
The type of vehicle (e.g., "Car").
Name
body
Type
string
Description
The body style of the vehicle (e.g., "Wagon").
Name
series
Type
string
Description
The vehicle series or generation (e.g., "Mk3 (2006-)").
Name
fuel_type
Type
string
Description
The type of fuel the vehicle uses (e.g., "Diesel").
Name
gears
Type
string
Description
The number of gears in the transmission (e.g., "6").
Name
emission_standard
Type
string
Description
The emission standard category represents the level of exhaust emissions a vehicle complies with, based on regulations set by regional authorities. These standards limit the amount of pollutants such as nitrogen oxides (NOx), carbon monoxide (CO), hydrocarbons (HC), and particulate matter (PM) that a vehicle can emit.
Common formats include:
- Euro 4, Euro 5, Euro 6 — European Union standards
- LEV, ULEV, SULEV — U.S. standards (Low Emission Vehicle tiers)
- 4L — May represent Euro 4 Light Duty classification or similar region-specific categories
Name
manufacturer
Type
string
Description
The name of the vehicle manufacturer (e.g., "FORD-WERKE GmbH, D-50735 KOELN").
Name
manufacturer_address
Type
string
Description
The address of the manufacturer (e.g., "Koeln-Niehl, Germany").
Name
plant_country
Type
string
Description
The country of manufacture (e.g., "Germany").
Name
engine_manufacturer
Type
string
Description
The manufacturer of the engine (e.g., "FORD").
Name
avg_co2_emission_g_km
Type
string
Description
The average CO₂ emissions produced by the vehicle, measured in grams per kilometer (g/km). This value represents how much carbon dioxide (CO₂) the vehicle emits on average while driving one kilometer, based on standardized testing cycles.
Lower CO₂ emissions generally indicate better fuel efficiency and reduced environmental impact. This metric is commonly used in Europe and other regions to assess a vehicle's environmental performance, and it may influence taxes or regulatory compliance.
For example, a value of 174.03 g/km means the vehicle emits approximately 174 grams of CO₂ for every kilometer driven.
Name
no_of_axels
Type
string
Description
The number of axles on the vehicle (e.g., "2").
Name
no_of_doors
Type
string
Description
The number of doors (e.g., "4").
Name
no_of_seats
Type
string
Description
The number of seats (e.g., "5-7").
Name
rear_brakes
Type
string
Description
The rear brake type (e.g., "Disc").
Name
steering_type
Type
string
Description
The type of steering system used in the vehicle (e.g., "Steering rack and pinion"). This describes the mechanism that connects the steering wheel to the wheels and determines how the driver controls the vehicle’s direction.
Common steering types include:
- Rack and Pinion: A widely used, precise steering system found in most passenger cars. It uses a gearset to convert rotational motion from the steering wheel into linear motion to turn the wheels.
- Recirculating Ball: Often used in trucks and older vehicles. It uses a series of ball bearings to reduce friction and steer larger vehicles effectively.
- Electric Power Steering (EPS): A modern system that uses electric motors instead of hydraulic pressure for improved efficiency and driver assist features. The steering system affects handling, road feedback, and overall driving experience.
Name
rear_suspension
Type
string
Description
The rear suspension setup (e.g., "Independent multi-link spring suspension with stabilizer").
Name
front_suspension
Type
string
Description
The front suspension setup (e.g., "Independent, type McPherson with coil spring and anti-roll bar").
Name
wheel_size
Type
string
Description
The standard wheel size (e.g., "215/60 R16 94H").
Name
wheel_size_array
Type
string
Description
A list of available wheel sizes for the vehicle, typically including tire width, aspect ratio, rim diameter, and load/speed rating (e.g., "215/60 R16 94H"). Useful for identifying compatible tires and wheels.
Name
wheelbase_mm
Type
string
Description
The wheelbase length in millimeters (e.g., "2850").
Name
wheelbase_array_mm
Type
string
Description
A list of wheelbase measurements in millimeters (e.g., "2850").
Name
height_mm
Type
string
Description
The height of the vehicle in millimeters (e.g., "1807").
Name
length_mm
Type
string
Description
The length of the vehicle in millimeters (e.g., "4820").
Name
width_mm
Type
string
Description
The width of the vehicle in millimeters (e.g., "1884").
Name
track_front_mm
Type
string
Description
The front track width in millimeters (e.g., "1588").
Name
track_rear_mm
Type
string
Description
The rear track width in millimeters (e.g., "1605").
Name
max_speed_kmh
Type
string
Description
The maximum speed in kilometers per hour (e.g., "193").
Name
max_trunk_capacity_liters
Type
string
Description
The maximum trunk volume the vehicle can offer with seats folded or removed, measured in liters (e.g., "2325"). Indicates total available cargo space.
Name
min_trunk_capacity_liters
Type
string
Description
The minimum trunk volume with all seats in their upright position, measured in liters (e.g., "308"). Represents the standard cargo capacity.
Name
weight_empty_kg
Type
string
Description
The curb weight of the vehicle in kilograms (e.g., "1806").
Name
max_weight_kg
Type
string
Description
The maximum gross weight in kilograms (e.g., "2505").
Name
max_roof_load_kg
Type
string
Description
The maximum permissible roof load in kilograms (e.g., "75").
Name
permitted_trailer_load_without_brakes_kg
Type
string
Description
The maximum trailer load without brakes in kilograms (e.g., "750").
Name
abs
Type
string
Description
Indicates whether the vehicle is equipped with Anti-lock Braking System (ABS) (e.g., "1" for true).
Name
check_digit
Type
string
Description
The VIN check digit, used for validating the VIN (e.g., "W").
Name
sequential_number
Type
string
Description
The sequential production number of the vehicle (e.g., "R43240").
Name
timestamp
Type
string
Description
The timestamp of when the data was generated or retrieved (e.g., "2025-04-04T09:13:45.835Z").

Frequently asked questions

Request

GET

/v1/international-vin-decoder

  curl -G https://api.carsxe.com/v1/international-vin-decoder \
    -d key=CARSXE_API_KEY \
    -d vin=WF0MXXGBWM8R43240

Response

{
  "success": true,
  "input": {
      "vin": "WF0MXXGBWM8R43240"
  },
  "attributes": {
      "vin": "WF0MXXGBWM8R43240",
      "vid": "1623",
      "make": "Ford",
      "model": "Galaxy",
      "year": "2008",
      "product_type": "Car",
      "body": "Wagon",
      "series": "Mk3 (2006-)",
      "fuel_type": "Diesel",
      "gears": "6",
      "emission_standard": "4L",
      "manufacturer": "FORD-WERKE GmbH, D-50735 KOELN",
      "manufacturer_address": "Koeln-Niehl, Germany",
      "plant_country": "Germany",
      "engine_manufacturer": "FORD",
      "avg_co2_emission_g_km": "174.03",
      "no_of_axels": "2",
      "no_of_doors": "4",
      "no_of_seats": "5-7",
      "rear_brakes": "Disc",
      "steering_type": "Steering rack and pinion",
      "rear_suspension": "Independent multi-link spring suspension with stabilizer",
      "front_suspension": "Independent, type McPherson with coil spring and anti-roll bar",
      "wheel_size": "215/60 R16 94H",
      "wheel_size_array": "215/60 R16 94H",
      "wheelbase_mm": "2850",
      "wheelbase_array_mm": "2850",
      "height_mm": "1807",
      "length_mm": "4820",
      "width_mm": "1884",
      "track_front_mm": "1588",
      "track_rear_mm": "1605",
      "max_speed_kmh": "193",
      "max_trunk_capacity_liters": "2325",
      "min_trunk_capacity_liters": "308",
      "weight_empty_kg": "1806",
      "max_weight_kg": "2505",
      "max_roof_load_kg": "75",
      "permitted_trailer_load_without_brakes_kg": "750",
      "abs": "1",
      "check_digit": "W",
      "sequential_number": "R4324"
  },
  "timestamp": "2025-04-11T00:05:36.457Z"
}

Specifications Recalls