Philippines Credit Bureau

verifies input data against credit header data obtained from the partnered sources from philippines for authorization get session token from authentication page { "name" "philippines credit bureau", "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 and dob\n verifies – name, address, dob and national id\n returned data full name (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 eyjpc3mioij0zxn0iiwiawf0ijoxnzqymzq4nda1lcjpcgeioiiznc4xnteumte3lji0osisinvpzci6mzazlcjvawqiojyylcjsawqioju1odizotgsimv4cci6mtc0mjm3nziwnswiyxvkijoiahr0chm6ly9pzhuuzgf0yxpvby5jb20ifq 48l8e5qw1mluyfu3y8lyq6yvxdpsj eqg3vkbvp9x q8b5xv1mohy8awm7qxij1adpqhfqclgw6qhubcwu6pga' \\\\\n data '{\n \\"countrycode\\" \\"ph\\",\n \\"service\\" \[\n \\"philippines credit bureau\\"\n ],\n \\"clientreference\\" \\"test 0001\\", \n \\"firstname\\" \\"lanie\\", \n \\"middlename\\" \\"g\\", \n \\"lastname\\" \\"avida\\", \n \\"dateofbirth\\" \\"1960 09 25\\", \n \\"addresselement1\\" \\"proper\\", \n \\"addresselement2\\" \\"buhisan\\", \n \\"addresselement3\\" \\"cebu city\\", \n \\"addresselement4\\" \\"\\", \n \\"addresselement5\\" \\"6000\\", \n \\"identityvariables\\" {\n \\"nationalidno\\" \\"1023456789\\", \n \\"nationalidtype\\" \\"sss\\" \n },\n \\"consentobtained\\" {\n \\"philippines credit bureau\\" 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 13ae5094 f4c3 48a7 86ee 5f20253a05ac\\",\n \\"matchstatus\\" \\"full match 1+1 verification\\",\n \\"searcherrormessage\\" \\"\\",\n \\"safeharbour\\" false,\n \\"searchstatus\\" \\"successful\\",\n \\"serviceresponses\\" {\n \\"philippines credit bureau\\" {\n \\"status\\" 0,\n \\"sourcestatus\\" \\"successful\\",\n \\"errormessage\\" \\"\\",\n \\"identityverified\\" true,\n \\"safeharbourscore\\" \\"l1\\",\n \\"namematchscore\\" \\"1 000\\",\n \\"addressmatchscore\\" \\"1 000\\",\n \\"verifications\\" {\n \\"addresselement1\\" true,\n \\"addresselement2\\" true,\n \\"addresselement3\\" true,\n \\"addresselement5\\" true,\n \\"dateofbirth\\" true,\n \\"firstname\\" true,\n \\"lastname\\" true,\n \\"middlename\\" true,\n \\"nationalidno\\" 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" "ph" }, { "name" "service", "kind" "required", "type" "array", "description" "philippines credit bureau" }, { "name" "clientreference", "kind" "optional", "type" "string", "description" "a client reference field" }, { "name" "fullname", "kind" "required", "type" "string", "description" "the fullname of the identity owner\n see the note below for more details " }, { "name" "firstname", "kind" "required", "type" "string", "description" "the first name (typically first name + middle name) of the identity owner \n see the note below for more details " }, { "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 see the note below for more details " }, { "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 (address elements separated by commas) of the identity owner\n see the note below for more details " }, { "name" "addresselement1", "kind" "optional", "type" "string", "description" "the house/unit number and street name of the address\n see the note below for more details " }, { "name" "addresselement2", "kind" "optional", "type" "string", "description" "the barangay (neighborhood or district) of the address\n see the note below for more details " }, { "name" "addresselement3", "kind" "optional", "type" "string", "description" "the city of the address\n see the note below for more details ", "children" \[] }, { "name" "addresselement4", "kind" "optional", "type" "string", "description" "the province of the address\n see the note below for more details ", "children" \[] }, { "name" "addresselement5", "kind" "optional", "type" "string", "description" "the post code of the address\n see the note below for more details ", "children" \[] }, { "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\n \[conditional optional see the note below for more details]" }, { "name" "nationalidtype", "kind" "required", "type" "string", "description" "type of the id (type should be, sss or tin or gsis)\n \[conditional optional see the note below for more details]" } ] }, { "name" "consentobtained", "kind" "required", "type" "object", "description" "consent given by the identity owner", "children" \[ { "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 credit bureau" }, { "name" "clientreference", "kind" "optional", "type" "string", "description" "a client reference field" }, { "name" "fullname", "kind" "required", "type" "string", "description" "the fullname of the identity owner\n see the note below for more details " }, { "name" "firstname", "kind" "required", "type" "string", "description" "the first name (typically first name + middle name) of the identity owner \n see the note below for more details " }, { "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 see the note below for more details " }, { "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 (address elements separated by commas) of the identity owner\n see the note below for more details " }, { "name" "addresselement1", "kind" "optional", "type" "string", "description" "the house/unit number and street name of the address\n see the note below for more details " }, { "name" "addresselement2", "kind" "optional", "type" "string", "description" "the barangay (neighborhood or district) of the address\n see the note below for more details " }, { "name" "addresselement3", "kind" "optional", "type" "string", "description" "the city of the address\n see the note below for more details ", "children" \[] }, { "name" "addresselement4", "kind" "optional", "type" "string", "description" "the province of the address\n see the note below for more details ", "children" \[] }, { "name" "addresselement5", "kind" "optional", "type" "string", "description" "the post code of the address\n see the note below for more details ", "children" \[] }, { "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\n \[conditional optional see the note below for more details]" }, { "name" "nationalidtype", "kind" "required", "type" "string", "description" "type of the id (type should be, sss or tin or gsis)\n \[conditional optional see the note below for more details]" } ] }, { "name" "consentobtained", "kind" "required", "type" "object", "description" "consent given by the identity owner", "children" \[ { "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\\"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 \\"philippines credit bureau\\" 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" "m1, m2, n1, l1, l2, l3, l4 or l5\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" "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" "returns additional data from the data source ", "children" \[ { "name" "address", "kind" "optional", "type" "string", "description" "full address of the individual \n included or omitted based on the client's configured settings" } ] } ] }, { "name" "remarks", "kind" "optional", "type" "array", "description" "will return remarks regarding any encountered issues or pre validation errors ", "children" \[] } ] } mandatory input for name either of the following must be provided ( firstname + lastname ) mandatory when fullname is not provided fullname is mandatory when ( firstname + lastname ) are not provided optional address input either of the following elements from addresselement(s) when fulladdress is not provided fulladdress is when elements from addresselement(s) are not provided national id input in the api call, the national id number input can be omitted or set as optional based on the configuration in the client's account settings links