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.

Get a vehicle by its registration number

get

Get a vehicle by its registration number

Authorizations

ApiKeyAuth

ApiKeystringRequired

Path parameters

plate_numberstringRequired

Plate number of the registered vehicle

Query parameters

statestringOptional

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

prefer_more_resultsbooleanOptional

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.

featuresstringOptional

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

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

upstream_vehiclestringOptional

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.

confidencestring · enumOptional

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.

Possible values:

colourstringOptional

The colour of the vehicle, if known

vinstringOptional

The VIN of the vehicle, if known

extended_dataanyOptional

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

writeoff_infoobjectOptional

400

Bad Request

application/json

401

Unauthorized

application/json

404

Not Found

application/json

get

/v2/vehicles/registrations/{plate_number}

HTTPcURLJavaScriptPython

GET /v2/vehicles/registrations/{plate_number} HTTP/1.1
Host: api.autograb.com.au
ApiKey: YOUR_API_KEY
Accept: */*

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

Example Response

The response below is a standard quality response for a vehicle search based on plate and state.

curl --location 'https://api.autograb.com.au/v2/vehicles/registrations/ccu542?region=au&state=vic'
--header 'ApiKey: YOURKEY'

{
    "success": true,
    "vehicle": {
        "id": "3583316061320587",
        "region": "au",
        "title": "2022 Tesla Model Y Electric Auto",
        "year": "2022",
        "make": "Tesla",
        "model": "Model Y",
        "badge": null,
        "series": null,
        "model_year": "MY22",
        "release_month": 6,
        "release_year": 2022,
        "body_type": "SUV",
        "body_config": null,
        "transmission": "Automatic",
        "transmission_type": "Automatic",
        "wheelbase": null,
        "wheelbase_type": null,
        "fuel": "Electric",
        "fuel_type": "Electric",
        "engine": "Electric",
        "engine_type": "Electric",
        "drive": "RWD",
        "drive_type": "Rear Wheel Drive",
        "num_doors": 5,
        "num_seats": 5,
        "num_gears": 1,
        "num_cylinders": null,
        "capacity_cc": null,
        "power_kw": 220,
        "torque_nm": 350,
        "range": null,
        "battery_kwh": 60,
        "roof_type": null,
        "options": []
    },
    "upstream_vehicle": "2022 TESLA MODEL Y AUTO RWD ELECTRIC SUV 220kw 1sp 5dr 5seat",
    "vin": "LRWYHCFS6NC428809",
    "colour": "GREY",
    "confidence": "standard",
    "additional_vehicles": [],
    "plate_module": {
        "plate": "ccu542",
        "plate_state": "VIC"
    }
}

The State Parameter

This is a required parameter for the region. You must send the state in its short format; you can use the extended format for front-end purposes if necessary.

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

Features

You can request more data than the standard payload by leveraging a range of features described below. You can request one or many features at once in a comma separated list.

curl --location 'https://api.autograb.com.au/v2/vehicles/vins/JTDKW3D380D521439?features=writeoff_info%2Cregistration_status%2Cextended_data&region=au' \
--header 'ApiKey: YOURKEY'

Refer to the Vehicle Search Feature page for a full list of supported features.