---
title: "International VIN Decoding"
description: "Decode non-US VINs from international markets into structured vehicle identity, manufacturer, and technical attributes."
canonical_url: "https://docs.carsxe.com/docs/products/international-vin-decoder"
markdown_url: "https://docs.carsxe.com/docs/products/international-vin-decoder.md"
last_updated: "1980-01-01"
---

# International VIN Decoding
URL: /docs/products/international-vin-decoder
LLM index: /llms.txt
Description: Decode non-US VINs from international markets into structured vehicle identity, manufacturer, and technical attributes.

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](/docs/products/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

<CodeGroup title="Decode an international VIN" tag="GET" label="/v1/international-vin-decoder">

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

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

const carsxe = new CarsXE("YOUR_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("YOUR_API_KEY")
vin = "WF0MXXGBWM8R43240"

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

```bash {{ 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",
    "manufacturer": "FORD-WERKE GmbH, D-50735 KOELN",
    "plant_country": "Germany",
    "wheelbase_mm": "2850",
    "height_mm": "1807",
    "length_mm": "4820",
    "width_mm": "1884",
    "max_speed_kmh": "193"
  },
  "timestamp": "2025-04-11T00:05:36.457Z"
}
```

</CodeGroup>

## Response

For the full interactive reference, try it live in the [API Reference](/api-reference/specifications/international-vin-decoder).

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

<Properties>
  <Property name="success" type="boolean">
    `true` when the VIN was decoded successfully.
  </Property>
  <Property name="input" type="object">
    Echoes the VIN submitted in the request.
  </Property>
  <Property name="attributes" type="object">
    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.
  </Property>
  <Property name="timestamp" type="string">
    ISO 8601 response time.
  </Property>
</Properties>

### Common attribute groups

<details>
<summary>**Identity** — Core decoded vehicle identity</summary>

<Properties>
  <Property name="vin" type="string">
    The decoded vehicle identification number. Example: `"WF0MXXGBWM8R43240"`.
  </Property>
  <Property name="make" type="string">
    Manufacturer or brand. Example: `"Ford"`.
  </Property>
  <Property name="model" type="string">
    Model family. Example: `"Galaxy"`.
  </Property>
  <Property name="year" type="string">
    Model year when available. Example: `"2008"`.
  </Property>
  <Property name="product_type" type="string">
    Vehicle category such as `"Car"` or `"Truck"`.
  </Property>
  <Property name="body" type="string">
    Body classification such as `"Wagon"` or `"Pickup"`.
  </Property>
</Properties>

</details>

<details>
<summary>**Manufacturer and plant** — Builder and production details</summary>

<Properties>
  <Property name="manufacturer" type="string">
    Manufacturer name and address when supplied by the decoding source.
  </Property>
  <Property name="manufacturer_address" type="string">
    Manufacturer address when available separately.
  </Property>
  <Property name="plant_country" type="string">
    Country where the vehicle was built. Example: `"Germany"`.
  </Property>
  <Property name="engine_manufacturer" type="string">
    Engine manufacturer when available.
  </Property>
</Properties>

</details>

<details>
<summary>**Technical data** — Engine, dimensions, capacity, and VIN metadata</summary>

<Properties>
  <Property name="fuel_type" type="string">
    Fuel type such as `"Diesel"` or `"Gasoline"`.
  </Property>
  <Property name="gears" type="string">
    Transmission gear count when decoded.
  </Property>
  <Property name="wheelbase_mm" type="string">
    Wheelbase in millimeters when available.
  </Property>
  <Property name="height_mm" type="string">
    Vehicle height in millimeters when available.
  </Property>
  <Property name="length_mm" type="string">
    Vehicle length in millimeters when available.
  </Property>
  <Property name="width_mm" type="string">
    Vehicle width in millimeters when available.
  </Property>
  <Property name="check_digit" type="string">
    VIN check digit.
  </Property>
  <Property name="sequential_number" type="string">
    VIN sequential production number segment.
  </Property>
</Properties>

</details>

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.
Docs-scoped sitemap: [/docs/sitemap.md](/docs/sitemap.md).
Well-known sitemap: [/.well-known/sitemap.md](/.well-known/sitemap.md).