NZ Driver Licence Check API
/nz_driver_licence
The NZ Driver Licence Check API endpoint validates a New Zealand driver licence against the NZTA database. It requires both the licence number and the version number. The driver licence is the primary document used in identity verification workflows.
Example Request
POSTRequest Schema
first_name
First name as it appears on the licence. Omit for single-name (mononym) licence holders.
middle_name
Middle name if present on the licence.
last_name
Last name as it appears on the licence.
birth_date
Date of birth in YYYY-MM-DD format.
licence_number
Must be a valid NZ driver licence number.
licence_version
The 3-digit version number from the front of the licence
consent
Must be true. Confirms consent has been obtained.
Available Response Data
4 Data Pointsreporting_reference
string - Unique transaction identifier.
match_status
string - Enum: "Match" "NoMatch" Overall match result. Match indicates the supplied identity was fully verified; NoMatch indicates verification failed.
document_verified
boolean - Whether NZTA reports the supplied licence details as verified. Defaults to false when the source did not return a verification verdict.
additional_information
An explanatory message returned by the data source about the result. Only present when the source supplied one - typically alongside a NoMatch result.
API Data Scale & Coverage tag
Unmatched data depth to power your compliance and verification workflows.
Sandbox Environment
When simulating queries in the sandbox environment, the following record will return a match:
| First Name | Last Name | Date of Birth | Licence Number | Licence Version |
|---|---|---|---|---|
| Dana | Mitchell | 1965-09-13 | DB512036 | 001 |
Technical Use Cases tag
KYC identity verification
The driver licence is the most common document presented during customer onboarding. Verifying it against the NZTA database establishes international KYC compliance under the AML/CTF Act.
Account recovery
Confirm customer identity during a password reset or step-up authentication event.
Contractor onboarding
Verify credentials for businesses with a mandatory licence requirement. This applies to rideshare operators and fleet managers.
Compliance & Security tag
Enterprise-grade infrastructure audited against the standards your regulators require.
Common Questions tag
Everything you need to know about implementation details and compliance infrastructure.
help_center General
Do I need the version number as well as the licence number?
add
Do I need the version number as well as the licence number?
Yes. You must submit the version number for all queries. The licence number identifies the individual driver. The version number identifies the specific physical card. This requirement prevents validation using an expired or cancelled document.
Ready to integrate NZ Driver Licence Check API?
Talk to our team about credentials, sandbox access and the right combination of endpoints for your workflow.
