Sequenced Searching

sequenced searching in philippines can be configured for clients upon request when making sequenced calls for philippines , the api input for the service must be set to "philippines residential" example api requests and responses with following services configured philippines residential philippines credit bureau { "name" "philippines sequenced search", "method" "post", "url" "https //idu test datazoo com/api/v2/verify", "description" " verification outcome – kyc verification from sequenced searching and returns single or duel (where possible) source matches\n consumer consent – yes\n mandatory input – name, dob and national id\n verifies – name, address, dob and national id\n returned data full name, type of data source, service identifier and full address (if configured) ", "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 eyjpc3mioij0zxn0iiwiawf0ijoxnzqyoduxndc0lcjpcgeioiiznc4xnteumte3lji0osisinvpzci6mzazlcjvawqiojyylcjsawqioju2mtu1mdgsimv4cci6mtc0mjg4mdi3ncwiyxvkijoiahr0chm6ly9pzhuuzgf0yxpvby5jb20ifq qyso4svmvqkdtkxpw1qlsuyagqiodl2sa xazqduy4exkglshhhfzsfz1gwfjebz5c npf8jxfitbvoptmcxoq' \\\\\n data '{\n \\"countrycode\\" \\"ph\\",\n \\"service\\" \[\n \\"philippines residential\\"\n ],\n \\"clientreference\\" \\"test 0001\\", \n \\"firstname\\" \\"lanie\\",\n \\"middlename\\" \\"g\\",\n \\"lastname\\" \\"avida\\",\n \\"dateofbirth\\" \\"1960 09 25\\", \n \\"addresselement1\\" \\"cebu region 7\\",\n \\"addresselement2\\" \\"tangil\\",\n \\"addresselement3\\" \\"dumanjug\\",\n \\"addresselement4\\" \\"cebu\\",\n \\"addresselement5\\" \\"6035\\",\n \\"identityvariables\\" {\n \\"nationalidno\\" \\"1023456789\\",\n \\"nationalidtype\\" \\"sss\\"\n },\n \\"consentobtained\\" {\n \\"philippines residential\\" true\n }\n}'", "customlabel" "" } ], "selectedlanguageid" "f2jmy98siubrop0bgc788" }, "results" { "languages" \[ { "id" " kllvb jxqiuu wuwqaf", "language" "200", "customlabel" "", "code" "{\n \\"countrycode\\" \\"philippines\\",\n \\"clientreference\\" \\"test 0001\\",\n \\"reportingreference\\" \\"dz acd0008c 38b5 44c6 8981 a333ac55dc60\\",\n \\"matchstatus\\" \\"full match 2+2 verification\\",\n \\"searcherrormessage\\" \\"\\",\n \\"safeharbour\\" true,\n \\"searchstatus\\" \\"successful\\",\n \\"serviceresponses\\" {\n \\"philippines credit bureau\\" {\n \\"status\\" 1,\n \\"sourcestatus\\" \\"successful\\",\n \\"errormessage\\" \\"\\",\n \\"identityverified\\" true,\n \\"safeharbourscore\\" \\"l2\\",\n \\"namematchscore\\" \\"1 000\\",\n \\"addressmatchscore\\" \\"0 200\\",\n \\"verifications\\" {\n \\"addresselement1\\" false,\n \\"addresselement2\\" false,\n \\"addresselement3\\" false,\n \\"addresselement4\\" true,\n \\"addresselement5\\" false,\n \\"dateofbirth\\" true,\n \\"firstname\\" true,\n \\"lastname\\" true,\n \\"middlename\\" true,\n \\"nationalidno\\" true\n },\n \\"returneddata\\" {\n \\"category\\" \\"credit\\",\n \\"source\\" \\"dz2\\"\n }\n },\n \\"philippines residential\\" {\n \\"status\\" 0,\n \\"sourcestatus\\" \\"successful\\",\n \\"errormessage\\" \\"\\",\n \\"identityverified\\" true,\n \\"safeharbourscore\\" \\"m1\\",\n \\"namematchscore\\" \\"1 000\\",\n \\"addressmatchscore\\" \\"1 000\\",\n \\"verifications\\" {\n \\"addresselement1\\" true,\n \\"addresselement2\\" true,\n \\"addresselement3\\" true,\n \\"addresselement4\\" true,\n \\"addresselement5\\" true,\n \\"barangay\\" true,\n \\"city\\" true,\n \\"dateofbirth\\" true,\n \\"firstname\\" true,\n \\"lastname\\" true,\n \\"middlename\\" true,\n \\"province\\" true,\n \\"region\\" true,\n \\"street\\" true\n },\n \\"returneddata\\" {\n \\"address\\" \\"cebu region 7, tangil, dumanjug, cebu, 6035\\",\n \\"category\\" \\"consumer\\",\n \\"source\\" \\"dz1\\"\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" "ph" }, { "name" "service", "kind" "required", "type" "array", "description" "philippines residential" }, { "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\n mandatory if firstname and lastname are not provided" }, { "name" "firstname", "kind" "required", "type" "string", "description" "first name of the identity owner\n mandatory if fullname is not provided" }, { "name" "middlename", "kind" "optional", "type" "string", "description" "the middle name(s) of the identity owner" }, { "name" "lastname", "kind" "required", "type" "string", "description" "the last name of the identity owner\n mandatory if fullname is not provided" }, { "name" "dateofbirth", "kind" "required", "type" "string", "description" "in yyyy mm dd (preferred) or dd mm yyyy format" }, { "name" "fulladdress", "kind" "optional", "type" "string", "description" "the full address of the identity owner" }, { "name" "addresselement1", "kind" "optional", "type" "string", "description" "the street level address of the identity owner" }, { "name" "addresselement2", "kind" "optional", "type" "string", "description" "the extended street level address eg building name (if applicable)", "children" \[] }, { "name" "addresselement3", "kind" "optional", "type" "string", "description" "the suburb address of the identity owner", "children" \[] }, { "name" "addresselement4", "kind" "optional", "type" "string", "description" "the state address of the identity owner", "children" \[] }, { "name" "addresselement5", "kind" "required", "type" "string", "description" "the postcode of the address of the identity owner", "children" \[ { "name" "", "kind" "required", "type" "string", "description" "" } ] }, { "name" "identityvariables", "kind" "required", "type" "object", "description" "other elements for verification", "children" \[ { "name" "nationalidno", "kind" "required", "type" "string", "description" "national id number of the identity owner" }, { "name" "nationalidtype", "kind" "required", "type" "string", "description" "type of the id (should be, sss or tin or gsis)" } ] }, { "name" "consentobtained", "kind" "required", "type" "object", "description" "consent given by the identity owner", "children" \[ { "name" "philippines residential", "kind" "required", "type" "boolean", "description" "should be true" }, { "name" "philippines credit bureau", "kind" "required", "type" "boolean", "description" "should be true" } ] } ], "schema" \[ { "name" "countrycode", "kind" "required", "type" "string", "description" "ph" }, { "name" "service", "kind" "required", "type" "array", "description" "philippines residential" }, { "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\n mandatory if firstname and lastname are not provided" }, { "name" "firstname", "kind" "required", "type" "string", "description" "first name of the identity owner\n mandatory if fullname is not provided" }, { "name" "middlename", "kind" "optional", "type" "string", "description" "the middle name(s) of the identity owner" }, { "name" "lastname", "kind" "required", "type" "string", "description" "the last name of the identity owner\n mandatory if fullname is not provided" }, { "name" "dateofbirth", "kind" "required", "type" "string", "description" "in yyyy mm dd (preferred) or dd mm yyyy format" }, { "name" "fulladdress", "kind" "optional", "type" "string", "description" "the full address of the identity owner" }, { "name" "addresselement1", "kind" "optional", "type" "string", "description" "the street level address of the identity owner" }, { "name" "addresselement2", "kind" "optional", "type" "string", "description" "the extended street level address eg building name (if applicable)", "children" \[] }, { "name" "addresselement3", "kind" "optional", "type" "string", "description" "the suburb address of the identity owner", "children" \[] }, { "name" "addresselement4", "kind" "optional", "type" "string", "description" "the state address of the identity owner", "children" \[] }, { "name" "addresselement5", "kind" "required", "type" "string", "description" "the postcode of the address of the identity owner", "children" \[ { "name" "", "kind" "required", "type" "string", "description" "" } ] }, { "name" "identityvariables", "kind" "required", "type" "object", "description" "other elements for verification", "children" \[ { "name" "nationalidno", "kind" "required", "type" "string", "description" "national id number of the identity owner" }, { "name" "nationalidtype", "kind" "required", "type" "string", "description" "type of the id (should be, sss or tin or gsis)" } ] }, { "name" "consentobtained", "kind" "required", "type" "object", "description" "consent given by the identity owner", "children" \[ { "name" "philippines residential", "kind" "required", "type" "boolean", "description" "should be true" }, { "name" "philippines credit bureau", "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" "philippines", "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" "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" "dateofbirth", "kind" "optional", "type" "boolean", "description" "" }, { "name" "firstname", "kind" "optional", "type" "boolean", "description" "" }, { "name" "fulladdress", "kind" "optional", "type" "boolean", "description" "" }, { "name" "fullname", "kind" "optional", "type" "boolean", "description" "" }, { "name" "lastname", "kind" "optional", "type" "boolean", "description" "" }, { "name" "middlename", "kind" "optional", "type" "boolean", "description" "" }, { "name" "nationalidno", "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" "full address of the individual (philippines residential returns by default setting)\n included or omitted based on the client's configured settings" }, { "name" "category", "kind" "optional", "type" "string", "description" "data source type or category (example, telco, consumer etc)" }, { "name" "fullname", "kind" "optional", "type" "string", "description" "full name of the individual \n included or omitted based on the client's configured settings" }, { "name" "source", "kind" "optional", "type" "string", "description" "identifies the data source used " } ] } ] }, { "name" "remarks", "kind" "optional", "type" "array", "description" "will return remarks regarding any encountered issues or pre validation errors ", "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 returns a distinct response block with service specific data structure and behavior each key within serviceresponses corresponds to a service name , representing an individual verification source 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 , addresselement1 , dateofbirth , firstname ) the returneddata block provides metadata, including category and source , indicating the data provider used for verification