Registration Plate Search

Find vehicle information from a registration plate.

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), number plate & API key. This will return either a matching vehicle with possible option packs, or a null.

In all cases, and importantly if a matching vehicle is unable to be identified, we will return the upstream_vehicle field allowing you to identify how the relevant road transport authority describes the vehicle. Depending on your use case you may wish to allow front-end users to manually classify the vehicle using the upstream_vehicle as a guide to fill out a Facet-style search.

Get a vehicle by its registration number

Get a vehicle by its registration number

GET/v2/vehicles/registrations/{plate_number}

Authorization

ApiKeyAuth

Path parameters

plate_number*string

Plate number of the registered vehicle

Query parameters

Response

200400401404

Success

Body

*/*

successboolean

vehicleVehicle (object)

upstream_vehiclestring

The raw vehicle description. It is recommended that end users manually verify that this value corresponds to the same vehicle type as the "vehicle" object above.

confidenceenum

The confidence that the vehicle was matched correctly. If this is 'reduced', it's recommended to manually check or prompt your end user to check if the vehicle is correct.

standardreduced

colourstring

The colour of the vehicle, if known

vinstring

The VIN of the vehicle, if known

additional_vehiclesarray of Vehicle (object)

Any additional alternate vehicle matches beyond the first (usually most likely) match

extended_dataany

Extended Data vehicle description product which can be selected by providing the appropriate query parameter

registration_statusRegistrationStatusProduct (object)

vehicle_ageVehicleAgeProduct (object)

writeoff_infoWriteoffInfoProduct (object)

build_dataVehicleBuildData (object)

odo_historyEnhancedLookupOdoHistory (array of object)

odo_predictionEnhancedLookupOdoPrediction (object)

vsrrEnhancedLookupVsrr (object)

Request

JavaScriptCurlPython

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

Response

200400401404

{
  "success": true,
  "vehicle": {
    "id": "text",
    "region": "au",
    "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
  },
  "upstream_vehicle": "text",
  "confidence": "standard",
  "colour": "text",
  "vin": "text",
  "additional_vehicles": [
    {
      "id": "text",
      "region": "au",
      "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
    }
  ],
  "registration_status": {
    "expiry_date": "text",
    "status": "text"
  },
  "vehicle_age": {
    "compliance_plate": "text",
    "year_of_manufacture": 0
  },
  "build_data": {
    "vin": "text",
    "build_date": "text",
    "make": "text",
    "model": "text",
    "features": [
      {
        "code": "text",
        "value": "text"
      }
    ]
  },
  "odo_history": [
    {
      "read_date": "text",
      "odometer": 0
    }
  ],
  "odo_prediction": {
    "prediction": 0,
    "days_since_read": 0,
    "avg_yearly": 0,
    "avg_daily": 0,
    "ag_market_avg": 0
  },
  "vsrr": {
    "fuel_economy": {
      "star_rating": 0,
      "consumption": 0
    },
    "emissions": {
      "co2": 0,
      "star_rating": 0
    },
    "pollutants": {
      "star_rating": 0,
      "test_regime": "text"
    },
    "safety": {
      "driver": {
        "star_rating": 0,
        "test_regime": "text"
      }
    }
  }
}

Components

Success - this denotes the outcome of the lookup, if this is not true there are several possible reasons. The plate does not exist, was entered incorrectly or the registration authority could be experiencing an outage (refer to our status page).

Vehicle - this is the array that holds the vehicle data as a result of our matching operation. If Vehicle:Null then we have not been able to identify a matching vehicle. If this is powering a front end UX you should prompt the user to search via Facets Search to resolve to a vehicle ID. You can use theUpstream_Vehicle below as a UI guide.

Upstream_Vehicle - this is what the Registration Authority has told us the vehicle is. We use this input to match our catalogue.

ID - this is the platform ID of the vehicle, your gateway to leveraging this vehicle in future Valuation, Vehicle Data and more requests.

Summary Data - you will find basic information about the vehicle that you can use to power your UX. If you require more information that is in the Vehicle array consider usage of Vehicle Data endpoints.

Options - these are fittable (not fitted) options available on this vehicle. If you require fitted (from factory data) use the Options Data endpoint.

Confidence - this is the prediction confidence of the match. There are two types of output for this parameter (Standard and degraded).

Additional Vehicle - if there are additional lower confidence matches we will show them to you here.

Features

You can pass in features to request additional data to be sent in the response. Refer to the Features section for more information.

The State Parameter

Australia - this is a required parameter for the region. You must send the state in its short format, you can use the long format for front end purposes if you require.

State (Short	State (Long)
NSW	New South Wales
NT	Northern Territory
QLD	Queensland
SA	South Australia
TAS	Tasmania
VIC	Victoria
WA	Western Australia
ACT	Australian Capital Territory

Prefer More Results

This feature will show you additional results at lower-quality matches. Only use this if you would like to see other vehicles that are not likely to be the one you are requesting. Use headerprefer_more_results=true in order to request this response.