1 of 1

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), the number plate, and the API key. It will return either a matching vehicle or a null.

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

Features

You can request more data than the standard payload by leveraging a range of features described below.

Ensure your commercial agreement has these features enabled if you require them.

Extended Data

This feature will return an extended payload of vehicle data from the registration authority. Use features=extended_data to receive this payload.

   "extended_data": {
        "body_type_description": "CAR/SEDAN",
        "color_description": "WHITE",
        "engine_number": "DKJ039523",
        "make_code": "VOLKS",
        "make_description": "",
        "model_code": "",
        "model_description": "POLO",
        "vehicle_type_description": "CAR / SMALL PASSENGER VEHICLE"

Upstream Data

This feature will return structured descriptive data from the registration authority. Use features=additional_upstream_data to receive this payload.

    "additional_upstream_data": {
        "vin": "WVWZZZAWZKU065305",
        "year": "2019",
        "make": "Volkswagen",
        "model": "Polo",
        "badge": "AW",
        "series": "85TSI Comfortline",
        "fuel_type": "95 RON PULP",
        "body_style": "Hatch",
        "transmission": "7 auto",
        "capacity_cc": "1000",
        "colour": "White",
        "title": "2019 Volkswagen AW Polo 85TSI Comfortline 4 Hatch 7sp auto 1.0L 1000cc 3cyl T/Petrol 2018"

Build Data

This feature will return the options fitted to the vehicle based on your Factory Build Data. It will show all options, the price and if it is fitted to the vehicle or not. Usefeatures=build_data

"build_data": {
        "vin": "WAUZZZ8V7K1028938",
        "make": "AUDI",
        "model": "A3",
        "features": [
            {
                "code": "0A1",
                "value": "2 doors"
            },
            {
                "code": "0AE",
                "value": "Front stabilizer bar"
            },
            {
                "code": "0B2",
                "value": "Wheelbase"
            },
        ],
        "build_date": "2019-03-20"

Refer to Factory Build Data reference material for more information on supported OEMs.

Registration Plate Search

Find vehicle information from a registration plate.

Overview

Get a vehicle by its registration number

GET/v2/vehicles/registrations/{plate_number}

Authorization

Path parameters

plate_number*string

Plate number of the registered vehicle

Query parameters

statestring

State is used in the AU region to narrow down a numberplate

prefer_more_resultsboolean

If enabled, a larger selection of vehicles may be returned and a manual selection would be required to select the correct vehicle. This is disabled by default in favor of a system which will infer the correct vehicle and order the results by likelihood of behind correct.

featuresstring

Comma separated list of additional registration lookup data codes, if using (e.g. additional_upstream_data)

regionenum

The region to perform this request in

aunzukmy

reference_idstring

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

Response

Success

Body

successboolean

vehicleVehicle (object)

idstring

regionRegion (enum)

aunzukmy

titlestring

yearnumber

makestring

modelstring

badgestring

seriesstring

body_typestring

body_configstring

transmissionstring

wheelbasestring

fuelstring

enginestring

drivestring

num_doorsnumber

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

idstring

regionRegion (enum)

aunzukmy

titlestring

yearnumber

makestring

modelstring

badgestring

seriesstring

body_typestring

body_configstring

transmissionstring

wheelbasestring

fuelstring

enginestring

drivestring

num_doorsnumber

extended_dataany

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

registration_statusRegistrationStatusProduct (object)

expiry_datestring

statusstring

vehicle_ageVehicleAgeProduct (object)

compliance_platestring

year_of_manufacturenumber

writeoff_infoWriteoffInfoProduct (object)

build_dataVehicleBuildData (object)

vinstring

build_datestring

makestring

modelstring

featuresarray of object

codestring

valuestring

odo_historyEnhancedLookupOdoHistory (array of object)

read_datestring

ISO 8601 odometer read date

odometernumber

odo_predictionEnhancedLookupOdoPrediction (object)

predictionnumber

days_since_readnumber

avg_yearlynumber

avg_dailynumber

ag_market_avgnumber

vsrrEnhancedLookupVsrr (object)

fuel_economyobject

star_ratingnumber

consumptionnumber

emissionsobject

co2number

star_ratingnumber

pollutantsobject

star_ratingnumber

test_regimestring

safetyobject

driverobject

star_ratingnumber

test_regimestring

Request

Response

Features

You can request more data than the standard payload by leveraging a range of features described below.

Ensure your commercial agreement has these features enabled if you require them.

Extended Data

This feature will return an extended payload of vehicle data from the registration authority. Use features=extended_data to receive this payload.

   "extended_data": {
        "body_type_description": "CAR/SEDAN",
        "color_description": "WHITE",
        "engine_number": "DKJ039523",
        "make_code": "VOLKS",
        "make_description": "",
        "model_code": "",
        "model_description": "POLO",
        "vehicle_type_description": "CAR / SMALL PASSENGER VEHICLE"

Upstream Data

This feature will return structured descriptive data from the registration authority. Use features=additional_upstream_data to receive this payload.

    "additional_upstream_data": {
        "vin": "WVWZZZAWZKU065305",
        "year": "2019",
        "make": "Volkswagen",
        "model": "Polo",
        "badge": "AW",
        "series": "85TSI Comfortline",
        "fuel_type": "95 RON PULP",
        "body_style": "Hatch",
        "transmission": "7 auto",
        "capacity_cc": "1000",
        "colour": "White",
        "title": "2019 Volkswagen AW Polo 85TSI Comfortline 4 Hatch 7sp auto 1.0L 1000cc 3cyl T/Petrol 2018"

Build Data

This feature will return the options fitted to the vehicle based on your Factory Build Data. It will show all options, the price and if it is fitted to the vehicle or not. Usefeatures=build_data

"build_data": {
        "vin": "WAUZZZ8V7K1028938",
        "make": "AUDI",
        "model": "A3",
        "features": [
            {
                "code": "0A1",
                "value": "2 doors"
            },
            {
                "code": "0AE",
                "value": "Front stabilizer bar"
            },
            {
                "code": "0B2",
                "value": "Wheelbase"
            },
        ],
        "build_date": "2019-03-20"

Refer to Factory Build Data reference material for more information on supported OEMs.

Get a vehicle by its registration number

GET/v2/vehicles/registrations/{plate_number}

Authorization

Path parameters

plate_number*string

Plate number of the registered vehicle

Query parameters

statestring

State is used in the AU region to narrow down a numberplate

prefer_more_resultsboolean

featuresstring

Comma separated list of additional registration lookup data codes, if using (e.g. additional_upstream_data)

regionenum

The region to perform this request in

aunzukmy

reference_idstring

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

Response

Success

Body

successboolean

vehicleVehicle (object)

idstring

regionRegion (enum)

aunzukmy

titlestring

yearnumber

makestring

modelstring

badgestring

seriesstring

body_typestring

body_configstring

transmissionstring

wheelbasestring

fuelstring

enginestring

drivestring

num_doorsnumber

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

idstring

regionRegion (enum)

aunzukmy

titlestring

yearnumber

makestring

modelstring

badgestring

seriesstring

body_typestring

body_configstring

transmissionstring

wheelbasestring

fuelstring

enginestring

drivestring

num_doorsnumber

extended_dataany

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

registration_statusRegistrationStatusProduct (object)

expiry_datestring

statusstring

vehicle_ageVehicleAgeProduct (object)

compliance_platestring

year_of_manufacturenumber

writeoff_infoWriteoffInfoProduct (object)

build_dataVehicleBuildData (object)

vinstring

build_datestring

makestring

modelstring

featuresarray of object

codestring

valuestring

odo_historyEnhancedLookupOdoHistory (array of object)

read_datestring

ISO 8601 odometer read date

odometernumber

odo_predictionEnhancedLookupOdoPrediction (object)

predictionnumber

days_since_readnumber

avg_yearlynumber

avg_dailynumber

ag_market_avgnumber

vsrrEnhancedLookupVsrr (object)

fuel_economyobject

star_ratingnumber

consumptionnumber

emissionsobject

co2number

star_ratingnumber

pollutantsobject

star_ratingnumber

test_regimestring

safetyobject

driverobject

star_ratingnumber

test_regimestring

Request

Response

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