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

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

successbooleanOptionalDefault: true

400

Bad Request

application/json

401

Unauthorized

application/json

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

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 Usage

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

Search via plate and state

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

Alternatively search by VIN

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

{
    "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"
    }
}