# Upstream Vehicle Search

The Upstream API allows you to search for registration authority information by registration plate or VIN. You will receive back what the vehicle is registered as with varying structured data that the authority holds.

You can request information on anything with a registration plate, which means motorbikes, caravans, trucks and so on. 

Importantly you will not receive a vehicle ID with these responses as we only maintain a catalogue for passenger vehicles. We are unable to match other vehicles like motorbikes or heavy trucks and are therefore unable to provide additional functions like valuation.

The request requires only a region, vin or registration plate and state plus an API key. 

{% hint style="warning" %}
You will not receive a vehicle ID with your response.
{% endhint %}

{% openapi src="/files/TapIOjKDYdyzufcTwuea" path="/v2/vehicles/vins/{vin}/upstream" 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**

If you would like to know what the registration authority records a vehicle as irrespective of AutoGrab matching. 

Search via plate and state

{% code overflow="wrap" %}

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

{% endcode %}

Alternatively search by VIN

{% code overflow="wrap" %}

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

{% endcode %}

```json
{
    "success": true,
    "payload": {
        "vin": "LRWYHCFS6NC428809",
        "year": "2022",
        "make": "Tesla",
        "model": "Model Y",
        "fuel_type": "Electric",
        "body_style": "Wagon",
        "transmission": "Direct drive",
        "capacity_cc": "0",
        "colour": "Grey",
        "title": "2022 Tesla Model Y 4 Wagon 1sp auto Electric 2022"
    }
}
```


---

# 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/upstream-vehicle-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.