# 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/my-autograb-api-doc/vehicle-search/facet-search).

{% openapi src="<https://1154811857-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUypmYo5OBsuC4nJIUOZk%2Fuploads%2FO1mxxRIRpDcKC6fr56tG%2Fswagger_fixed_final.json?alt=media&token=956f728c-69a3-4540-b468-70d8d8e1068d>" path="/v2/vehicles/registrations/{plate\_number}" method="get" %}
[swagger\_fixed\_final.json](https://1154811857-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUypmYo5OBsuC4nJIUOZk%2Fuploads%2FO1mxxRIRpDcKC6fr56tG%2Fswagger_fixed_final.json?alt=media\&token=956f728c-69a3-4540-b468-70d8d8e1068d)
{% 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"
```

### **Build Data**

This feature will return the options fitted to the vehicle based on your [Factory Build Data](https://devhub.autograb.com/my-autograb-api-doc/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/my-autograb-api-doc/vehicle-data/factory-build-data) reference material for more information on supported OEMs.
{% endhint %}

<br>