Know Your Customer
...
Global
Asia Pacific

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
Production
ο»Ώ

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

JSON
ο»Ώ

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)
401(Unauthorized)
403 (Forbidden)
500 (Internal Server Error)
409(Upstream Down
ο»Ώ

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 [email protected]. 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!

ο»Ώ