New Zealand Driver Licence

4 min

verifies input data against new zealand government agency (new zealand transport agency) for authorization get session token from authentication page name new zealand driver licence method post url https idu test datazoo com api v2 verify description verification outcome returns kyc verification n consumer consent yes n mandatory input name dob and driver licence data n verifies name dob and driver licence n returned data n a tab examples examples languages id f2jmy98siubrop0bgc788 language curl code curl location https idu test datazoo com api v2 verify n header content type application json n header authorization bearer eyjhbgcioijiuzuxmiisinr5cci6ikpxvcj9 eyjpc3mioij0zxn0iiwiawf0ijoxnzqyndizndm4lcjpcgeioiiznc4xnteumte3lji0osisinvpzci6mzazlcjvawqiojyylcjsawqioju1odcynjasimv4cci6mtc0mjq1mjizocwiyxvkijoiahr0chm6ly9pzhuuzgf0yxpvby5jb20ifq vgw6tl6bi4jztyyea11xv6z4rye nibm7uruaz7itavwxynekkpqpk4fcdfyoz ktwwy 5aitrx5ilzyju0gag n data n countrycode nz n service n new zealand driver licence n n clientreference test 0001 n firstname dana n middlename null n lastname mitchell n dateofbirth 1965 09 13 n identityvariables n driverslicenceno db512036 n t t driverslicenceversion 001 n n t consentobtained n new zealand driver licence true n n customlabel selectedlanguageid f2jmy98siubrop0bgc788 results languages id kllvb jxqiuu wuwqaf language 200 customlabel code n countrycode new zealand n clientreference test 0001 n reportingreference dz 8a2439b6 b8a4 450c 9ef0 ca382ceb482e n matchstatus full match 1 1 verification n searcherrormessage n safeharbour false n searchstatus successful n serviceresponses n new zealand driver licence n status 0 n sourcestatus successful n errormessage n identityverified true n safeharbourscore l2 n namematchscore 1 000 n addressmatchscore n a n verifications n dateofbirth true n driverslicenceno true n driverslicenceversion true n firstname true n lastname true n n returneddata n n n remarks n id as5tj4glqvhlg7b69q21j language 404 customlabel code n message ain t no cake like that n selectedlanguageid kllvb jxqiuu wuwqaf request pathparameters queryparameters headerparameters name authorization kind required type string description sessiontoken obtained via the authentication call sessiontoken obtained via the authentication call bodydataparameters name data kind required type object description request body sent to the api object children name countrycode kind required type string description nz name service kind required type array description new zealand driver licence name clientreference kind optional type string description a client reference field name firstname kind required type string description the first name of the identity owner n conditional optional see note below name middlename kind required type string description the middle name s of the identity owner n conditional optional see note below name lastname kind required type string description the last name of the identity owner name dateofbirth kind required type string description in yyyy mm dd preferred or dd mm yyyy format name identityvariables kind required type object description other elements for verification children name driverslicenceno kind required type string description drivers licence number name driverslicenceversion kind required type string description 3 digit number given on the front of a new zealand driver licence name consentobtained kind required type object description consent given by the identity owner children name new zealand driver licence kind required type boolean description should be true schema name countrycode kind required type string description nz name service kind required type array description new zealand driver licence name clientreference kind optional type string description a client reference field name firstname kind required type string description the first name of the identity owner n conditional optional see note below name middlename kind required type string description the middle name s of the identity owner n conditional optional see note below name lastname kind required type string description the last name of the identity owner name dateofbirth kind required type string description in yyyy mm dd preferred or dd mm yyyy format name identityvariables kind required type object description other elements for verification children name driverslicenceno kind required type string description drivers licence number name driverslicenceversion kind required type string description 3 digit number given on the front of a new zealand driver licence name consentobtained kind required type object description consent given by the identity owner children name new zealand driver licence kind required type boolean description should be true formdataparameters currentnewparameter label body parameter value bodydataparameters hastryitout false response name countrycode kind optional type string description new zealand children name clientreference kind optional type string description the client reference if given as input children name reportingreference kind optional type string description a reference number generated which is unique to each transaction children name validationerrors kind optional type string description returned with http status code 400 when the request contains invalid or improperly formatted input data children name matchstatus kind optional type string description full match 1 1 verification n no match name searcherrormessage kind optional type string description error message returned querying the data source children name safeharbour kind optional type boolean description true or false children name searchstatus kind optional type string description successful n not successful children name serviceresponses kind optional type object description verification details with new zealand driver licence returned as the service identifier children name status kind optional type integer description 0 identityverified true element verifications all true n2 identityverified false sourcestatus successful n3 identityverified false sourcestatus not successful name sourcestatus kind optional type string description successful n unsuccessful name errormessage kind optional type string description error message s from the data source example error querying data source name identityverified kind optional type boolean description true or false name safeharbourscore kind optional type string description m2 l2 or l5 n for more information refer to safe harbour scores page name namematchscore kind optional type string description 1 000 matched n 0 500 partial match n 0 000 no match name addressmatchscore kind optional type string description n a name verifications kind optional type object description element level verification returned as true or false children name dateofbirth kind optional type boolean description name driverslicenceno kind optional type boolean description name driverslicenceversion kind optional type boolean description name firstname kind optional type boolean description name lastname kind optional type boolean description name returneddata kind optional type object description returns additional data from the data source children name dpid kind optional type string description delivery point identifier of the address name remarks kind optional type array description null children mandatory and conditional optional input for name last name ( lastname ) input is required first name ( firstname ) and middle name(s) ( middlename ) must be given if present on the driver licence links