# 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](/vehicle-search/facet-search.md).

{% openapi src="/files/TapIOjKDYdyzufcTwuea" 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 %}

### Example Response

The response below is a standard quality response for a vehicle search based on plate and state.

```json
curl --location 'https://api.autograb.com.au/v2/vehicles/registrations/ccu542?region=au&state=vic'
--header 'ApiKey: YOURKEY'
```

```json
{
    "success": true,
    "vehicle": {
        "id": "3583316061320587",
        "region": "au",
        "title": "2022 Tesla Model Y Electric Auto",
        "year": "2022",
        "make": "Tesla",
        "model": "Model Y",
        "badge": null,
        "series": null,
        "model_year": "MY22",
        "release_month": 6,
        "release_year": 2022,
        "body_type": "SUV",
        "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": 5,
        "num_seats": 5,
        "num_gears": 1,
        "num_cylinders": null,
        "capacity_cc": null,
        "power_kw": 220,
        "torque_nm": 350,
        "range": null,
        "battery_kwh": 60,
        "roof_type": null,
        "options": []
    },
    "upstream_vehicle": "2022 TESLA MODEL Y AUTO RWD ELECTRIC SUV 220kw 1sp 5dr 5seat",
    "vin": "LRWYHCFS6NC428809",
    "colour": "GREY",
    "confidence": "standard",
    "additional_vehicles": [],
    "plate_module": {
        "plate": "ccu542",
        "plate_state": "VIC"
    }
}
```

### 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>

## 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.&#x20;

{% 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.&#x20;


---

# 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/registration-plate-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.