APAC
China
Composite Searching
3 min
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)