# VIN Search

The Vehicle VIN API allows you to search for vehicles by VIN. The request requires only a region, VIN, and API key. It will either return a matching vehicle with possible option packs or a null.

{% openapi src="<https://4010475651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFaCA1JqFKRrqIB0EfZlZ%2Fuploads%2FuDtxATuz0g12x4lhufjn%2Finsurance_updated.yaml?alt=media&token=2565c3ea-325e-4bf3-b8e4-31792a5c9e79>" path="/v2/vehicles/vins/{vin}" method="get" %}
[insurance\_updated.yaml](https://4010475651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFaCA1JqFKRrqIB0EfZlZ%2Fuploads%2FuDtxATuz0g12x4lhufjn%2Finsurance_updated.yaml?alt=media\&token=2565c3ea-325e-4bf3-b8e4-31792a5c9e79)
{% endopenapi %}

### **Example Response**

```json
{
    "success": true,
    "vehicle": {
        "id": "4568590518845440",
        "region": "au",
        "title": "2021 Tesla Model 3 Rear-Wheel Drive Auto",
        "year": "2021",
        "make": "Tesla",
        "model": "Model 3",
        "badge": "Rear-Wheel Drive",
        "series": null,
        "model_year": "MY21",
        "release_month": 11,
        "release_year": 2021,
        "body_type": "Sedan",
        "body_config": null,
        "transmission": "Reduction Gear",
        "transmission_type": "Reduction Gear",
        "wheelbase": null,
        "wheelbase_type": null,
        "fuel": "Electric",
        "fuel_type": "Electric",
        "engine": "Electric",
        "engine_type": "Electric",
        "drive": "RWD",
        "drive_type": "Rear Wheel Drive",
        "num_doors": 4,
        "num_seats": 5,
        "num_gears": 1,
        "num_cylinders": null,
        "capacity_cc": null,
        "power_kw": null,
        "torque_nm": null,
        "range": null,
        "options": [
            {
                "detail": "Standard Paint",
                "price": 0
            },
            {
                "detail": "Paint - Black",
                "price": 1500
            },
            {
                "detail": "Full Self Driving Capability",
                "price": 10100
            },
            {
                "detail": "Paint - Multi-Coat Red",
                "price": 2900
            },
            {
                "detail": "Interior - Black & White",
                "price": 1500
            },
            {
                "detail": "19\" Sport Wheels",
                "price": 2200
            }
        ]
    },
    "upstream_vehicle": "2021 TESLA MODEL 3 Sedan",
    "confidence": "standard",
    "additional_vehicles": []
}
```

### Features

You can request more data than the standard payload by leveraging a range of features described below.

{% hint style="info" %}
Ensure your commercial agreement has these features enabled if you require them.
{% endhint %}

#### **Extended Data**

This feature will return an extended payload of vehicle data from the registration authority. Use `features=extended_data` to receive this payload.

```json
   "extended_data": {
        "body_type_description": "CAR/SEDAN",
        "color_description": "WHITE",
        "engine_number": "DKJ039523",
        "make_code": "VOLKS",
        "make_description": "",
        "model_code": "",
        "model_description": "POLO",
        "vehicle_type_description": "CAR / SMALL PASSENGER VEHICLE"
```

#### **Upstream Data**

This feature will return structured descriptive data from the registration authority. Use `features=additional_upstream_data` to receive this payload.

```json
    "additional_upstream_data": {
        "vin": "WVWZZZAWZKU065305",
        "year": "2019",
        "make": "Volkswagen",
        "model": "Polo",
        "badge": "AW",
        "series": "85TSI Comfortline",
        "fuel_type": "95 RON PULP",
        "body_style": "Hatch",
        "transmission": "7 auto",
        "capacity_cc": "1000",
        "colour": "White",
        "title": "2019 Volkswagen AW Polo 85TSI Comfortline 4 Hatch 7sp auto 1.0L 1000cc 3cyl T/Petrol 2018"
```

#### **Vehicle Age**

This feature will return structured data on the age of a vehicle from the registration authority. Use `features=vehicle_age` to receive this payload.

```json
    "vehicle_age": {
        "compliance_plate": "2019-04",
        "year_of_manufacture": 2019
```

#### **Writeoff Information**

This feature will return information about the write-off status of a vehicle. Use `features=writeoff_info`

```json
  "writeoff_info": {
        "incident_list": [
            {
                "code": "Repairable Write-off",
                "damage_codes": "I04AI17DI21C",
                "jurisdiction": "VIC",
                "recorded_date": "2024-04-28",
                "type_code": "Collision"
            }
        ]
```

#### **Registration Status**

This feature will return information about the registration status of a vehicle. Use `features=registration_status`

```json
    "registration_status": {
        "expiry_date": "2024-09-06",
        "status": "REGISTERED"
    }
```

#### **Build Data**

This feature will return the options fitted to the vehicle based on your [Factory Build Data](https://devhub.autograb.com/vehicle-data/factory-build-data). It will show all options, the price, and whether or not it is fitted to the vehicle. Use`features=build_data`

```json
"build_data": {
        "vin": "WAUZZZ8V7K1028938",
        "make": "AUDI",
        "model": "A3",
        "features": [
            {
                "code": "0A1",
                "value": "2 doors"
            },
            {
                "code": "0AE",
                "value": "Front stabilizer bar"
            },
            {
                "code": "0B2",
                "value": "Wheelbase"
            },
        ],
        "build_date": "2019-03-20"
```

{% hint style="info" %}
&#x20;Refer to [Factory Build Data](https://devhub.autograb.com/vehicle-data/factory-build-data) reference material for more information on supported OEMs.&#x20;
{% endhint %}

<br>