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.

---

<Row>
  <Col>
    This endpoint allows you to retrieve **vehicle** information based on VIN.

    ## Required attributes

    <Properties>
      <Property name="key" type="string">
        Your CarsXE API key.
      </Property>
      <Property name="vin" type="string">
        The 17 character long vehicle identification number.
      </Property>
    </Properties>

    ## Response Attributes

    <Properties>
      <Property name="success" type="boolean">
        Indicates whether the request was <strong>successful</strong> (e.g., `true` or `false`).
      </Property>
      <Property name="input" type="object">
        Contains the <strong>input parameters</strong> used in the request.
        <Properties>
          <Property name="vin" type="string">
            The <strong>Vehicle Identification Number</strong> (VIN) (e.g., "WF0MXXGBWM8R43240").
          </Property>
        </Properties>
      </Property>
      <Property name="make" type="string">
        The <strong>vehicle manufacturer</strong> (e.g., "Ford").
      </Property>
      <Property name="model" type="string">
        The <strong>vehicle model</strong> (e.g., "Galaxy").
      </Property>
      <Property name="year" type="string">
        The <strong>manufacturing year</strong> of the vehicle (e.g., "2008").
      </Property>
      <Property name="product_type" type="string">
        The <strong>type of vehicle</strong> (e.g., "Car").
      </Property>
      <Property name="body" type="string">
        The <strong>body style</strong> of the vehicle (e.g., "Wagon").
      </Property>
      <Property name="series" type="string">
        The <strong>vehicle series or generation</strong> (e.g., "Mk3 (2006-)").
      </Property>
      <Property name="fuel_type" type="string">
        The <strong>type of fuel</strong> the vehicle uses (e.g., "Diesel").
      </Property>
      <Property name="gears" type="string">
        The <strong>number of gears</strong> in the transmission (e.g., "6").
      </Property>
      <Property name="emission_standard" type="string">
        The <strong>emission standard</strong> 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
      </Property>
      <Property name="manufacturer" type="string">
        The <strong>name of the vehicle manufacturer</strong> (e.g., "FORD-WERKE GmbH, D-50735 KOELN").
      </Property>
      <Property name="manufacturer_address" type="string">
        The <strong>address of the manufacturer</strong> (e.g., "Koeln-Niehl, Germany").
      </Property>
      <Property name="plant_country" type="string">
        The <strong>country of manufacture</strong> (e.g., "Germany").
      </Property>
      <Property name="engine_manufacturer" type="string">
        The <strong>manufacturer of the engine</strong> (e.g., "FORD").
      </Property>
      <Property name="avg_co2_emission_g_km" type="string">
        The <strong>average `CO₂` emissions</strong> 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.
      </Property>
      <Property name="no_of_axels" type="string">
        The <strong>number of axles</strong> on the vehicle (e.g., "2").
      </Property>
      <Property name="no_of_doors" type="string">
        The <strong>number of doors</strong> (e.g., "4").
      </Property>
      <Property name="no_of_seats" type="string">
        The <strong>number of seats</strong> (e.g., "5-7").
      </Property>
      <Property name="rear_brakes" type="string">
        The <strong>rear brake type</strong> (e.g., "Disc").
      </Property>
      <Property name="steering_type" type="string">
        The <strong>type of steering system</strong> 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:
          * <strong>Rack and Pinion:</strong> 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.
          * <strong>Recirculating Ball:</strong> Often used in trucks and older vehicles. It uses a series of ball bearings to reduce friction and steer larger vehicles effectively.
          * <strong>Electric Power Steering (EPS):</strong> 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.
      </Property>
      <Property name="rear_suspension" type="string">
        The <strong>rear suspension setup</strong> (e.g., "Independent multi-link spring suspension with stabilizer").
      </Property>
      <Property name="front_suspension" type="string">
        The <strong>front suspension setup</strong> (e.g., "Independent, type McPherson with coil spring and anti-roll
        bar").
      </Property>
      <Property name="wheel_size" type="string">
        The <strong>standard wheel size</strong> (e.g., "215/60 R16 94H").
      </Property>
      <Property name="wheel_size_array" type="string">
        A <strong>list of available wheel sizes</strong> 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.
      </Property>
      <Property name="wheelbase_mm" type="string">
        The <strong>wheelbase length</strong> in millimeters (e.g., "2850").
      </Property>
      <Property name="wheelbase_array_mm" type="string">
        A <strong>list of wheelbase measurements</strong> in millimeters (e.g., "2850").
      </Property>
      <Property name="height_mm" type="string">
        The <strong>height</strong> of the vehicle in millimeters (e.g., "1807").
      </Property>
      <Property name="length_mm" type="string">
        The <strong>length</strong> of the vehicle in millimeters (e.g., "4820").
      </Property>
      <Property name="width_mm" type="string">
        The <strong>width</strong> of the vehicle in millimeters (e.g., "1884").
      </Property>
      <Property name="track_front_mm" type="string">
        The <strong>front track width</strong> in millimeters (e.g., "1588").
      </Property>
      <Property name="track_rear_mm" type="string">
        The <strong>rear track width</strong> in millimeters (e.g., "1605").
      </Property>
      <Property name="max_speed_kmh" type="string">
        The <strong>maximum speed</strong> in kilometers per hour (e.g., "193").
      </Property>
      <Property name="max_trunk_capacity_liters" type="string">
        The <strong>maximum trunk volume</strong> the vehicle can offer with seats folded or removed, measured in liters (e.g., "2325"). Indicates total available cargo space.
      </Property>
      <Property name="min_trunk_capacity_liters" type="string">
        The <strong>minimum trunk volume</strong> with all seats in their upright position, measured in liters (e.g., "308"). Represents the standard cargo capacity.
      </Property>
      <Property name="weight_empty_kg" type="string">
        The <strong>curb weight</strong> of the vehicle in kilograms (e.g., "1806").
      </Property>
      <Property name="max_weight_kg" type="string">
        The <strong>maximum gross weight</strong> in kilograms (e.g., "2505").
      </Property>
      <Property name="max_roof_load_kg" type="string">
        The <strong>maximum permissible roof load</strong> in kilograms (e.g., "75").
      </Property>
      <Property name="permitted_trailer_load_without_brakes_kg" type="string">
        The <strong>maximum trailer load without brakes</strong> in kilograms (e.g., "750").
      </Property>
      <Property name="abs" type="string">
        Indicates whether the vehicle is equipped with <strong>Anti-lock Braking System (ABS)</strong> (e.g., "1" for true).
      </Property>
      <Property name="check_digit" type="string">
        The <strong>VIN check digit</strong>, used for validating the VIN (e.g., "W").
      </Property>
      <Property name="sequential_number" type="string">
        The <strong>sequential production number</strong> of the vehicle (e.g., "R43240").
      </Property>
      <Property name="timestamp" type="string">
        The <strong>timestamp</strong> of when the data was generated or retrieved (e.g., "2025-04-04T09:13:45.835Z").
      </Property>
    </Properties>

    <FAQ faqs={[{ question: "What VIN can I use for testing?", answer: <>You may use the following VIN for test: <code>WF0MXXGBWM8R43240</code></>},{question: "Is the International VIN Decoder API included in the free trial?", answer: <>No, The International VIN Decoder API is not included in the 7-day free trial. For more information visit our <a href='/pricing'>pricing</a> page.</>}, { question: "How can I get started with the API?", answer: "Getting started with the API is easy. Simply sign up for an account, and you'll be able to start using the API right away. You can also contact our sales team for more information."}]} />

  </Col>

  <Col sticky>

    <CodeGroup title="Request" tag="GET" label="/v1/international-vin-decoder">

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

      ```js
      import { CarsXE } from "carsxe-api";

      const carsxe = new CarsXE("CARSXE_API_KEY");
      const vin = "WF0MXXGBWM8R43240";

      try {
        const vehicle = await carsxe.internationalVinDecoder({ vin });
        console.log(vehicle);
      } catch (error) {
        console.error(error);
      }
      ```

      ```python
      import asyncio
      from carsxe_api import CarsXE

      carsxe = CarsXE('CARSXE_API_KEY')
      vin = 'WF0MXXGBWM8R43240'

      try:
          vehicle = asyncio.run(carsxe.int_vin_decoder({"vin": vin}))
          print(vehicle)
      except Exception as e:
          print(f"Error: {e}")
      ```

      ```php
      <?php
      require_once __DIR__ . '/vendor/autoload.php';
      use CarsxeDeveloper\Carsxe\Carsxe;

      $API_KEY = 'CARSXE_API_KEY';
      $carsxe = new Carsxe($API_KEY);
      $vin = 'WF0MXXGBWM8R43240';

      try {
          $vehicle = $carsxe->intVinDecoder(['vin' => $vin]);
          print_r($vehicle);
      } catch (Exception $error) {
          echo "Error: " . $error->getMessage();
      }
      ```

      ```ruby
      require 'carsxe'

      API_KEY = 'CARSXE_API_KEY'
      carsxe = Carsxe::CarsXE.new(api_key: API_KEY)
      vin = 'WF0MXXGBWM8R43240'

      begin
        vehicle = carsxe.int_vin_decoder('vin' => vin)
        puts vehicle
      rescue StandardError => error
        puts "Error: #{error.message}"
      end
      ```

      ```go
      package main

      import (
      	"fmt"
      	"github.com/carsxe/carsxe-go-package"
      )

      func main() {
      	client := carsxe.New("CARSXE_API_KEY")
      	vin := "WF0MXXGBWM8R43240"
      	vehicle := client.InternationalVINDecoder(map[string]string{"vin": vin})
      	fmt.Println(vehicle)
      }
      ```

      ```java
      import io.github.carsxe.CarsXE;
      import java.util.Map;
      import java.util.HashMap;

      public class Main {
          public static void main(String[] args) {
              CarsXE carsxe = new CarsXE("CARSXE_API_KEY");
              Map<String, String> params = new HashMap<>();
              params.put("vin", "WF0MXXGBWM8R43240");
              try {
                  Map<String, Object> vehicle = carsxe.internationalVinDecoder(params);
                  System.out.println(vehicle);
              } catch (Exception e) {
                  System.err.println("Error: " + e.getMessage());
              }
          }
      }
      ```

      ```swift
      import carsxe

      let carsxe = CarsXE(apiKey: "CARSXE_API_KEY")
      let vin = "WF0MXXGBWM8R43240"

      do {
          let vehicle = try carsxe.intVinDecoder(["vin": vin])
          print(vehicle)
      } catch {
          print("Error: \(error)")
      }
      ```

      ```csharp
      using carsxe;
      using System;
      using System.Collections.Generic;
      using System.Threading.Tasks;

      class Program
      {
          static async Task Main(string[] args)
          {
              string API_KEY = "CARSXE_API_KEY";
              CarsXE carsxe = new CarsXE(API_KEY);
              string vin = "WF0MXXGBWM8R43240";
              try
              {
                  var vehicle = await carsxe.InternationalVinDecoder(new Dictionary<string, string> { { "vin", vin } });
                  Console.WriteLine(vehicle);
              }
              catch (Exception ex)
              {
                  Console.WriteLine($"Error: {ex.Message}");
              }
          }
      }
      ```
    </CodeGroup>
    <CodeGroup title="Response">
    ```json showLineNumbers {{ title: '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"
    }
    ```
    </CodeGroup>

  </Col>
</Row>
```