New Zealand Yellow Pages

data zoo’s proprietary opt in permission based data sourced from c ommercial listed landline telephone numbers in new zealand for authorization get session token from authentication page name new zealand yellow pages method post url https idu test datazoo com api v2 verify description verification outcome returns kyc verification n consumer consent n a n mandatory input name and postcode n verifies name address and landline phone number n returned data structured details of name and address related to the landline phone number 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 eyjpc3mioij0zxn0iiwiawf0ijoxnzqynzgymdqylcjpcgeioiiznc4xnteumte3lji0osisinvpzci6mzazlcjvawqiojyylcjsawqioju2mta0otesimv4cci6mtc0mjgxmdg0miwiyxvkijoiahr0chm6ly9pzhuuzgf0yxpvby5jb20ifq piwacfhrsl0cv7ch5lymxkhv01cr7rswb9wjbgthgvgr ikb0q2hwfmy64mwekhf ou1dpzqtsug4ivr yihgq n data n countrycode nz n service n new zealand yellow pages n n clientreference test 0001 n firstname montgomery n lastname morrison n addresselement1 12 gemini place n addresselement3 kawaha point n addresselement4 rotorua n addresselement5 3010 n identityvariables n landlineno 073485798 n n preferenceoverrides n phone safeharbour true n 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 f65c8d68 170c 462d 8c12 fb9c59f2d718 n matchstatus full match 1 1 verification n searcherrormessage n safeharbour false n searchstatus successful n serviceresponses n new zealand yellow pages n status 0 n sourcestatus successful n errormessage n identityverified true n safeharbourscore n1 n namematchscore 1 000 n addressmatchscore 1 000 n verifications n addresselement1 true n addresselement3 true n addresselement4 true n addresselement5 true n firstname true n landlineno true n lastname true n n returneddata n phonedata n n address1 12 gemini place n city rotorua n firstname montgomery n homephoneno 073485798 n lastname morrison n middlename n postcode 3010 n suburb kawaha point n n n 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 yellow pages 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 name lastname kind required type string description the last name of the identity owner name addresselement1 kind required type string description the street level address of the identity owner n conditional optional see note below name addresselement2 kind required type string description the extended part of street level address if present of the identity owner n conditional optional see note below name addresselement3 kind optional type string description the suburb address of the identity owner name addresselement4 kind optional type string description the state address of the identity owner n children name addresselement5 kind required type string description the postcode of the address of the identity owner children name identityvariables kind optional type object description other elements for verification children name landlineno kind optional type string description landline number schema name countrycode kind required type string description nz name service kind required type array description new zealand yellow pages 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 name lastname kind required type string description the last name of the identity owner name addresselement1 kind required type string description the street level address of the identity owner n conditional optional see note below name addresselement2 kind required type string description the extended part of street level address if present of the identity owner n conditional optional see note below name addresselement3 kind optional type string description the suburb address of the identity owner name addresselement4 kind optional type string description the state address of the identity owner n children name addresselement5 kind required type string description the postcode of the address of the identity owner children name identityvariables kind optional type object description other elements for verification children name landlineno kind optional type string description landline number 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 yellow pages returned as the service identifier children name status kind optional type integer description 0 identityverified true element verifications all true n1 identityverified true element verifications not 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 n1 n for more information refer to safe harbour scores page name namematchscore kind optional type string description a string that acts as a value between 0 000 and 1 000 name addressmatchscore kind optional type string description a string that acts as a value between 0 000 and 1 000 name verifications kind optional type object description element level verification returned as true or false n only applicable elements will be included and not all elements may be present children name addresselement1 kind optional type boolean description name addresselement2 kind optional type boolean description name addresselement3 kind optional type boolean description name addresselement4 kind optional type boolean description name addresselement5 kind optional type boolean description name firstname kind optional type boolean description name landlineno 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 phonedata kind optional type array description returned structured details related to the landline phone number n each object within the array represents an individual record associated with a landline number and includes relevant personal and address related information name address1 kind optional type string description street level address element in phonedata name city kind optional type string description city where the individual or business is located element in phonedata name firstname kind optional type string description first name of the identity owner element in phonedata name homephoneno kind optional type string description landline phone number of the identity owner element in phonedata name lastname kind optional type string description last name of the identity owner element in phonedata name middlename kind optional type string description middle name s of the identity owner element in phonedata name postcode kind optional type string description post code of the address element in phonedata name suburb kind optional type string description suburb of the address element in phonedata name remarks kind optional type array description will return remarks regarding any encountered issues children mandatory input for address for address input addresselement5 is required along with either addresselement1 or addresselement2 must be provided as input links