Philippines Residential Check

overview the philippines residential check api facilitates the verification of personal and residential details against local databases to ensure accuracy and reliability of the information provided this api is tailored for organizations requiring precise address verification to mitigate risks associated with fraud and ensure compliance with local regulations usecase this api is utilized extensively by banks, real estate agencies, and utility companies, among others, to confirm the authenticity of the residential addresses provided by their customers it supports customer onboarding verifying the correctness of residential details provided during the onboarding process risk management helping in the assessment and mitigation of risks associated with falsified address information regulatory compliance assisting entities in meeting local compliance requirements by verifying customer details accurately api details request body preproduction curl location 'https //api preproduction signzy app/api/v3/global kyc/verify/ph/residential check' \\ \ header 'authorization < auth token >' \\ \ header 'content type application/json' \\ \ data raw '{ "firstname" "lanie", "lastname" "avida", "middlename" "g", "dateofbirth" "1960 09 25", "addressline1" "cebu region 7", "addressline2" "tangil", "addressline3" "dumanjug", "addressline4" "cebu", "addressline5" "6035", "consent" true }' production curl location 'https //api sig app/api/v3/global kyc/verify/ph/credit bureau' \\ \ header 'authorization < auth token >' \\ \ header 'content type application/json' \\ \ data raw '{ "firstname" "lanie", "lastname" "avida", "middlename" "g", "dateofbirth" "1960 09 25", "addressline1" "cebu region 7", "addressline2" "tangil", "addressline3" "dumanjug", "addressline4" "cebu", "addressline5" "6035", "identityinformation" { "nationalidnumber" "1023456789", "nationalidtype" "sss" }, "consent" true }' request body parameters parameter type description required firstname string first name of the individual yes lastname string last name of the individual yes middlename string middle name of the individual no dateofbirth date date of birth (format yyyy mm dd) yes addressline1 to 5 string components of the residential address no identityinformation object container for identity details yes nationalidnumber string national identification number yes nationalidtype string type of national id (e g , sss, tin) yes consent boolean consent from the individual to perform verification yes response body { "result" { "verificationresult" { "firstname" true, "middlename" true, "lastname" true, "dateofbirth" true, "addressline1" true, "addressline2" true, "addressline3" true, "addressline4" true, "addressline5" true, "namematchscore" "1 000", "addressmatchscore" "1 000" }, "verificationstatus" "verified", "reason" "all elements verified" } } response body parameters parameter type description verificationresult object detailed results of the individual data fields verified against the credit bureau data firstname boolean result of the first name verification; true if it matches the credit bureau records, false otherwise middlename boolean result of the middle name verification; true if it matches, false otherwise lastname boolean result of the last name verification; true if it matches, false otherwise dateofbirth boolean result of the date of birth verification; true if it matches, false otherwise addressline1 boolean verification result for the first line of the address; true if it matches, false otherwise addressline2 boolean verification result for the second line of the address; true if it matches, false otherwise addressline3 boolean verification result for the third line of the address; true if it matches, false otherwise addressline4 boolean verification result for the fourth line of the address; true if it matches, false otherwise addressline5 boolean verification result for the fifth line of the address; true if it matches, false otherwise namematchscore string numerical score representing the match quality of the name with the credit bureau records addressmatchscore string numerical score representing the match quality of the address with the credit bureau records verificationstatus string overall status of the verification, typically "verified" or "not verified" reason string description of why certain fields did not verify, listing all fields that were not verified error code and response mapping 400 (bad request) { "error" { "name" "error", "message" "bad input and description ", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" 400 } } 401(unauthorized) { "error" { "name" "error", "message" "invalid authentication credentials", "status" 401, "reason" "authentication error", "type" "bad request", "statuscode" 401 } } 403 (forbidden) { "error" { "name" "error", "message" "forbidden", "reason" "error", "type" "bad request", "statuscode" "403" } } 500 (internal server error) { "error" { "name" "error", "message" "internal server error", "status" 500, "reason" "error", "type" "bad request", "statuscode" 500 } } 409(upstream down { "error" { "name" "error", "message" "upstream down", "status" 409, "reason" "error", "type" "bad request", "statuscode" 409 } } field type description name string text displayed on the screen explaining error type reason string reason for the error status number http status code message string error message indicating an upstream error type string error type statuscode number status code representing the error scenario getting help please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better you can reach out to us at help\@signzy com we strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively we value your feedback and are committed to making your experience smooth and enjoyable our team is dedicated to assisting you with any needs you may have thank you for choosing our services we look forward to helping you!