# 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="/files/TapIOjKDYdyzufcTwuea" 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 Usage**

To request vehicle information with a VIN supply the VIN in your request. 

```
curl --location 'https://api.autograb.com.au/v2/vehicles/vins/LRW3F7FA1MC176142?region=au' \
--header 'ApiKey: YOURKEY'
```

```json
{
    "success": true,
    "vehicle": {
        "id": "4568590518845440",
        "region": "au",
        "title": "2021 Tesla Model 3 Electric Auto",
        "year": "2021",
        "make": "Tesla",
        "model": "Model 3",
        "badge": null,
        "series": null,
        "model_year": "MY21",
        "release_month": 11,
        "release_year": 2021,
        "body_type": "Sedan",
        "body_config": null,
        "transmission": "Automatic",
        "transmission_type": "Automatic",
        "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,
        "battery_kwh": null,
        "roof_type": null,
        "options": []
    },
    "upstream_vehicle": "2021 TESLA MODEL3 SEDAN",
    "confidence": "standard",
    "additional_vehicles": []
}
```

## Features

You can request more data than the standard payload by leveraging a range of features described below. You can request one or many features at once in a comma separated list. 

{% code overflow="wrap" %}

```json
curl --location 'https://api.autograb.com.au/v2/vehicles/vins/JTDKW3D380D521439?features=writeoff_info%2Cregistration_status%2Cextended_data&region=au' \
--header 'ApiKey: YOURKEY'
```

{% endcode %}

Refer to the [Vehicle Search Feature](/vehicle-search/vehicle-search-features.md) page for a full list of supported features. 


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://devhub.autograb.com/vehicle-search/vin-search.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.