# Registration Plate Search

### Overview

The Vehicle Registration API allows you to search for a vehicle by supplying its number plate. The request requires a region, the state (dependent on region), the number plate, and the API key. It will return either a matching vehicle or a null.

If a matching vehicle cannot be identified in all cases, we will return the `upstream_vehicle` field, allowing you to identify how the relevant road transport authority describes the car. Depending on your use case, you may wish to allow front-end users to manually classify the vehicle using the guide to fill out a Facet-style[ search](https://devhub.autograb.com/vehicle-search/facet-search).

{% 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/registrations/{plate\_number}" 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 %}

## 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 if it is fitted to the vehicle or not. 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" %}
Refer to [Factory Build Data](https://devhub.autograb.com/vehicle-data/factory-build-data) reference material for more information on supported OEMs.
{% endhint %}

\
The State Parameter

This is a required parameter for the region. You must send the state in its short format; you can use the extended format for front-end purposes if necessary.

<table><thead><tr><th width="148">State (Short</th><th>State (Long)</th></tr></thead><tbody><tr><td><code>NSW</code></td><td>New South Wales</td></tr><tr><td><code>NT</code></td><td>Northern Territory</td></tr><tr><td><code>QLD</code></td><td>Queensland</td></tr><tr><td><code>SA</code></td><td>South Australia</td></tr><tr><td><code>TAS</code></td><td>Tasmania</td></tr><tr><td><code>VIC</code></td><td>Victoria</td></tr><tr><td><code>WA</code></td><td>Western Australia</td></tr><tr><td><code>ACT</code></td><td>Australian Capital Territory</td></tr></tbody></table>

<br>