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 upstream vehicle data using a VIN

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

Authorization

ApiKeyAuth

Path parameters

vin*string

Plate number of the registered vehicle

Query parameters

Response

200400401

Success

Body

*/*

successboolean

payloadUpstreamVehicle (object)

Request

JavaScriptCurlPython

const response = await fetch('/v2/vehicles/vins/{vin}/upstream', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400401

{
  "success": true,
  "payload": {
    "title": "text",
    "year": 0,
    "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": 0
  }
}

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