Composite Searching

composite search in china enables clients to automate the selection of multiple services, processing verification inputs through successive data sources and returning responses from each selected service example api requests and responses with following four services configured china bank card china id verification china phone these services are queried simultaneously to retrieve data from each source name china composite search method post url https idu test datazoo com api v2 verify description verification outcome kyc verification from composite searching and returns single or duel source matches n consumer consent yes n mandatory input name dob id card number bank card number and phone number n verifies name dob and other input elements given for verification n returned data service identifier applicable for china id verification only n 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 chn n service n china id verification n china bank card n china phone n n clientreference test 0001 n t fullname n dateofbirth 1988 07 22 n identityvariables n idcardno 422822198807221014 n bankcardno 6221885200057396436 n phoneno 13971081932 n n consentobtained n china id verification true n china bank card true n china phone true n n n customlabel selectedlanguageid f2jmy98siubrop0bgc788 results languages id kllvb jxqiuu wuwqaf language 200 customlabel code n countrycode china n clientreference test 0001 n reportingreference dz 9707ec9b e448 45d8 af67 5682b0b71c3b n matchstatus full match 2 2 verification n searcherrormessage n safeharbour true n searchstatus successful n serviceresponses n china bank card 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 bankcardno true n dateofbirth true n fullname true n idcardno true n n returneddata n n china id verification 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 fullname true n idcardno true n n returneddata n address n gender n source dz4 n n n china phone n status 2 n sourcestatus successful n errormessage unsuccessful n identityverified false n safeharbourscore none n namematchscore n a n addressmatchscore n a n verifications n dateofbirth false n documentnumber false n fullname false n phoneverified false 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 chn name service kind required type array description china id verification china bank card china phone name clientreference kind optional type string description a client reference field name fullname kind required type string description the full 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 idcardno kind required type string description national id number of the identity owner name bankcardno kind required type string description bank card number of the identity owner name phoneno kind required type string description phone number of the identity owner name consentobtained kind required type object description consent given by the identity owner children name china id verification kind required type boolean description should be true name china bank card kind required type boolean description name china phone kind required type boolean description schema name countrycode kind required type string description chn name service kind required type array description china id verification china bank card china phone name clientreference kind optional type string description a client reference field name fullname kind required type string description the full 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 idcardno kind required type string description national id number of the identity owner name bankcardno kind required type string description bank card number of the identity owner name phoneno kind required type string description phone number of the identity owner name consentobtained kind required type object description consent given by the identity owner children name china id verification kind required type boolean description should be true name china bank card kind required type boolean description name china phone kind required type boolean description formdataparameters currentnewparameter label body parameter value bodydataparameters hastryitout false response name countrycode kind optional type string description china 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 full match 2 2 verification n no match name searcherrormessage kind optional type string description nerror 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 refer to the section at the bottom of the page titled service responses overview 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 nerror 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 refer to the section at the bottom of the page titled service responses overview n for more information refer to safe harbour scores page name namematchscore kind optional type string description refer to the section at the bottom of the page titled service responses overview name addressmatchscore kind optional type string description refer to the section at the bottom of the page titled service responses overview name verifications kind optional type object description refer to the section at the bottom of the page titled service responses overview children name bankcardno kind optional type boolean description name dateofbirth kind optional type boolean description name documentnumber kind optional type boolean description name fullname kind optional type boolean description name idcardno kind optional type boolean description name phoneverified kind optional type boolean description name returneddata kind optional type object description refer to the section at the bottom of the page titled service responses overview children name address kind optional type string description data source type or category example telco consumer etc name gender kind optional type string description name source kind optional type string description identifies the data source used name remarks kind optional type array description null children service responses overview each service returns its own self contained response block, ensuring modular and source specific verification results consumers of this api should handle varying response structures dynamically based on the requested services service responses element the serviceresponses object in the api response contains verification results from one or more data sources, structured under their respective service names each service (e g , "china id verification" , "china phone" from example 1) returns a distinct response block with service specific data structure and behavior services may return data from a single source or multiple sources in a sequenced api call the structure of each service response varies, with fields such as status , identityverified , and safeharbourscore differing between services the verifications block contains service specific boolean indicators for individual verification checks (e g , dateofbirth , fullname, idcardno ) the returneddata block provides metadata (if applicable)