Generating Vehicle Reports

Please note that for any transaction which was generated more than 30 days ago, private owner and or personally identifiable information has been suppressed in accordance with our privacy obligations. To view the latest private owner information please regenerate the report.

The reports include different types such as:

• Comprehensive Vehicle Information Report (VIR),

• Motor Check,

• Basic Vehicle Information (BVI),

• and Chassis Check.

Some reports, like Chassis Check + RedBook, include additional RedBook codes or valuation information. Each report type is available in XML format, and errors are prefixed with "MC-". Specific reasons for requesting private owner information must comply with privacy regulations, and responses are documented

The vehicle to generate the report on can be specified in different ways with different sets of parameters:

• vehicleId : Vehicle ID of an existing vehicle in the MotorWeb system against this account (most probably this ID will have been retrieved from a previous transaction). A new report will be generated based on the existing vehicle's identifiers and linked to this vehicle.

• stockNumber : Stock number of an existing vehicle in the MotorWeb system against this account. A new report will be generated based on the existing vehicle identifiers and linked to this vehicle.

• plate , or vin , or plateOrVin : Either a registration plate number (6 or less characters) or a VIN (Vehicle Identification Number) of exactly 17 characters. A new vehicle will be created in the MotorWeb system linked to the report generated.

• stockNumber : An optional reference the client uses to refer to this vehicle. This value is available in the MotorWeb user interface and is labeled "Stock number" (it can be labeled differently per account).

• specificReason : A mandatory reference specifying why a vehicle's private owner information is being requested. This is as a result of the privacy requirements of Section 241 of the Land Transport Act. Specified reasons are detailed in section 4 of the following notices:

  • https://gazette.govt.nz/notice/id/2017-au5430

  • https://gazette.govt.nz/notice/id/2017-au5432

Responses to all of these transactions are in XML format (text/xml). The schema for the response is vir-4.0 .xsd. The schema also documents the different codes that can be returned for certain fields.

You can easily see the differences between what the transactions return in Example URL: https://robot.motorweb.co.nz/action/robot-vehicle-report-data-matrix.xls.

Additional upstream errors from the Government registry can be returned which are all prefixed with "MC-". The most common of these are:

MotorWeb-Error-Code	Description
MC-21	Invalid plate number or VIN
MC-22	No vehicle found matching plate or VIN
MC-23	Confidential owner
MC-44	Plate has not been used
MC-…	Other errors returned from NZTA