Upstream Vehicle Search

Access registration authority information to get unmatched vehicle data from a plate or VIN.

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.

You will not receive a vehicle ID with your response.

Get upstream vehicle data using a VIN

get

Get upstream vehicle data using a VIN

Authorizations

ApiKeyAuth

ApiKeystringRequired

Path parameters

vinstringRequired

Plate number of the registered vehicle

Query parameters

regionstring · enumOptional

The region to perform this request in

Possible values:

reference_idstringOptional

An optional reference id which will be stored against usage records if supplied

Responses

200

Success

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

get

/v2/vehicles/vins/{vin}/upstream

HTTPcURLJavaScriptPython

GET /v2/vehicles/vins/{vin}/upstream HTTP/1.1
Host: api.autograb.com.au
ApiKey: YOUR_API_KEY
Accept: */*

{
  "success": true,
  "payload": {
    "title": "text",
    "year": 1,
    "make": "text",
    "model": "text",
    "badge": "text",
    "series": "text",
    "body_type": "text",
    "body_config": "text",
    "transmission": "text",
    "wheelbase": "text",
    "fuel": "text",
    "engine": "text",
    "drive": "text",
    "num_doors": 1
  }
}

Example

{
    "success": true,
    "payload": {
        "vin": "KMHLC41DMCU016619",
        "year": "2012",
        "make": "Hyundai",
        "model": "i40",
        "badge": "VF",
        "series": "Premium",
        "fuel_type": "91 RON ULP",
        "body_style": "Sedan",
        "transmission": "6 auto",
        "capacity_cc": "2000",
        "colour": "Grey",
        "title": "2012 Hyundai VF i40 Premium 4 Sedan 6sp auto 2.0L 2000cc 4cyl Petrol 2012"
    }
}