Driver Licence Verification and Checks
Overview
This title covers all the types of transactions discussed on the page, including basic driver checks, enhanced checks with additional details, and licence verification.
These transactions can (optionally) be linked to an existing vehicle in the MotorWeb system with one of the following 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).stockNumber: Stock number of an existing vehicle in the MotorWeb system against this account. If no existing vehicle is found then a new one is created and this stock number is applied to it. This is can be used as a reference the client uses to refer the vehicle this check relates to. Stock number is available in the MotorWeb user interface and is labeled "Stock number" (it can be labeled differently per account).
Driver check
Check that a licence is valid, current, what classes it is applicable for, and much more. The format of the text/xml response can be seen in the driver-check-1.1.xsd schema.
All of the following parameters must be specified:
licenceNumber: The driver's licence number (2 alpha follwed by 6 numeric characters, e.g. BD635033) labelled as "5a" on the physical licence.licenceVersion: The driver's licence card version (e.g. 879) labelled as "5b" on the physical licence. Temporary licenses do not have versions and therefore cannot be checked through Driver Check.lastName: The driver's last name (or surname or family name) labelled as "1" on the physical licence.
Additional errors are possible for this transaction:
CDI-59038
Invalid Driver Licence details entered Occurs when the licence number and version does not match a current licence in the NZTA's Driver Licence Register.
CDI-59034
Driver's Licence number does not match name entered
Current version: 1.1
Example URL: https://robot.motorweb.co.nz/action/robotDriverCheck/1.1?licenceNumber=BD635033&licenceVersion=004&lastName=SMITH
Driver check plus
Check that a licence is valid, current, what classes it is applicable for, and much more. In addition, this transaction allows a date of birth to be checked against the specified driver licence. The format of the text/xml response can be seen in the driver-check-plus-1.0.xsd schema.
All of the following parameters must be specified:
licenceNumber: The driver's licence number (2 alpha followed by 6 numeric characters, e.g. BD635033) labelled as "5a" on the physical licence.licenceVersion: The driver's licence card version (e.g. 879) labelled as "5b" on the physical licence. Temporary licenses do not have versions and therefore cannot be checked through Driver Check.lastName: The driver's last name (or surname or family name) labelled as "1" on the physical licence.
The following optional parameters will be checked against the details on the physical licence.
dateOfBirth: The driver's date of birth labelled as "3" on the physical licence. In the format YYYY-MM-DD.
Additional errors are possible for this transaction:
CDI-59038
Invalid Driver Licence details entered Occurs when the licence number and version does not match a current licence in the NZTA's Driver Licence Register.
CDI-59034
Driver's Licence number does not match name entered
Current version: 1.0
Example URL: https://robot.motorweb.co.nz/b2b/driver-check-plus/generate/1.0?licenceNumber=BD635033&licenceVersion=004&lastName=SMITH&dateOfBirth=1975-10-28
Licence verification
Confirm that a licence number matches a current New Zealand driver's licence. If the number (and version) matches then other identity details provided are matched against that physical licence. The format of the text/xml response can be seen in the licence-verification-2.0.xsd schema.
Other suppliers of similar services are unable to verify licences that aren't current (e.g. disqualified, suspended or limited) or have expired endorsements (e.g. dangerous goods endoresement has expired but the licence is still valid). MotorWeb's licence verification service does not have these problems.
All of the following parameters must be specified:
licenceNumber: The driver's licence number (e.g. BD635033) labelled as "5a" on the physical licence.licenceVersion: The driver's licence card version (e.g. 004) labelled as "5b" on the physical licence. Temporary licenses do not have versions and therefore cannot be checked through Driver Check.
The following parameters will be checked against the details on the physical licence. They will only be checked if the licence number and version (above) matched a licence that can be used as a valid form of identity. All of these parameters are optional - you only need to pass through the identity elements you wish to check.
lastName: The driver's last name (or surname or family name) labelled as "1" on the physical licence.firstName: The driver's first name labelled as "2" on the physical licence.middleNames: The driver's middle names (if any) are the second line under label "2" on the physical licence.dateOfBirth: The driver's date of birth labelled as "3" on the physical licence. In the format YYYY-MM-DD.
When the licence is not current or has expired endorsements:
Date of birth verification is unavailable, and
If the last name is not supplied or does not match the physical licence then first name and middle name verification is unavailable, and the status is unavailable.
Current version: 2.0
Example URL: https://robot.motorweb.co.nz/b2b/licence/verify/2.0?licenceNumber=BD635033&licenceVersion=004&lastName=SMITH&dateOfBirth=1975-01-09
Last updated