Vehicle Ownership Confirmation Methods

Please note: Confirm owner follows our new URL pattern: https://robot.motorweb.co.nz/b2b/owner/confirm/Method/Version?Parameters

Overview

This feature allows for confirming vehicle ownership for vehicles with prior VIR or Motor Check transactions. There are three methods to confirm ownership:

1. By First and Last Name: Requires the owner's first and last name.

2. By Last Name and Date of Birth: Requires the owner's last name and date of birth.

3. By Driver's Licence Number: Requires the owner's driver's licence number.

Confirm Owner

Confirm owner is only available for vehicle's with a VIR or Motor Check transaction already done.

Use one of the following parameters to specify the vehicle to confirm the owner of:

• reference : Reference number of the report to confirm. Reference is different to all other retrieval methods in that it will load reports belonging to any account and loads a specific report rather than the latest one linked to a vehicle.

• vehicleId : Confirms against the latest vehicle report for the vehicle with this ID (most probably this ID will have been retrieved from a previous transaction).

• stockNumber : Confirms against the latest vehicle report for the vehicle with this stock number. In the possible (but silly) case where multiple vehicles have the same stock number the vehicle that most recently had a transaction performed against it will be used.

An additional error is possible for these transactions:

MotorWeb-Error-Code	Situation
NO-OWNER-INFO	There is no VIR or Motor Check against this vehicle.

There are 3 different "flavors" of Confirm Owner. In each instance all the parameters are mandatory. The format of the text/xml response can be seen in the confirm-owner-1.0.xsd schema.

Confirm by first and last name

Method: name Current version: 1.0

• firstName: The owner's first name

• lastName: The owner's last name (or surname or family name)

Example URL: https://robot.motorweb.co.nz/b2b/owner/confirm/name/1.0?stockNumber=XYZ&firstName=john&lastName=smith

Confirm by last name and date of birt

Method: dob-and-lastname Current version: 1.0

• lastName: The owner's last name (or surname or family name)

• dateOfBirth: The owner's date of birth in the format YYYY-MM-DD

Example URL: https://robot.motorweb.co.nz/b2b/owner/confirm/dob-and-lastname/1.0?reference=aab45de6&lastName=smith&dateOfBirth=1978-06-16

Confirm by driver's licence number

Method: licence Current version: 1.0

• licenceNumber: The driver's licence number (e.g. BD635033) labelled as "5a" on the physical licence.

Example URL: https://robot.motorweb.co.nz/b2b/owner/confirm/licence/1.0?vehicleId=123456789&licenceNumber=BD635033