Skip to main content
NHVR Portal API - Vehicle registrations search

How to use the Vehicle Registrations Search controller method

Updated over 2 years ago

Prerequisites

To access the vehicle registrations search controller method you need to establish an API user to access the NHVR Developer Platform. For a step by step guide see Logging into the Developer Platform.

Using the vehicle registration search API

The vehicle registration search API is exposed from the VehicleRegistration controller from the NHVR Portal - Vehicle Service.

Every call to the vehicle registration search API should include the following headers:

Header

Value

Note

Content-Type

'application/json'

All calls are made using JSON data structures

Ocp-Apim-Subscription-Key

Your subscription key for the NHVR Portal API

The subscription key uniquely identifies you to the NHVR Portal API

The search endpoint uses the GET method and has three parameters:

  1. qs

  2. coordinate

  3. utcoffset

qs and coordinate

The vehicle plate number should be provided against the qs parameter.

The longitude and latitude of the location from which the caller identifies the vehicle registration should be provided against the coordinate parameter.

The qs and coordinate parameters are both required to perform a search.

https://api-public.nhvr.gov.au/vehicle/vehicleRegistrations/search?qs=HEAVY1&coordinate={"longitude": 123.0998233, "latitude": 89.9232332}

UTC offset

The registration expiry date is returned based on Australian Eastern Standard Time (AEST) with a UTC offset of 600. To return an expiry date corrected for the caller's timezone the caller should provide their local UTC offset against the utcoffset parameter.

https://api-public.nhvr.gov.au/vehicle/vehicleRegistrations/search?qs=HEAVY1&utcoffset=650

Specification

The full vehicle registration search API specification is available on the NHVR Developer Platform: VehicleRegistrationController.search.

The return results schema is provided below for quick reference:

[{
"vehicleId": "",
"vehicleVin": "*************1234",
"vehicleMake": "MACK",
"vehicleModel": "R700 SUPER-LINER",
"vehicleYearManufactured": 1989,
"vehicleChassisNumber": "AJ123456",
"vehicleBodyType": "Flat top truck",
"vehiclePrimaryColour": "Cream",
"vehicleTareMass": 9.2,
"vehicleGvm": 23.2,
"vehicleGcm": 45.1,
"registrationJurisdiction": "ACT",
"registrationPlateNumber": "HVPLATE",
"registrationEndDate": "2022-07-24T00:00:00Z",
"registrationChargeCode": "SP3",
"registrationConcessionType": "Primary producer (heavy trailers)",
"registrationStatus": "Registered",
"registrationLastUpdated": "2022-07-24T00:00:00Z",
"isPbsVehicleApproved": true,
"dangerousGoods": {
"classes": [
["1"]
],
"licenceNumber": "DVB000000",
"expiryDate": "2024-07-24T00:00:00Z",
"condition": ""
},
"pbsRecords": [{
"vehicleApprovalNo": "123"
}],
"avmrecords": [{
"label": "Q123456",
"moduleMass": true,
"moduleMaintenance": true
}]
}]

Did this answer your question?