Global KYC
The Global KYC API is a powerful tool that acts as a digital identity detective. It empowers businesses and organizations to confirm the accuracy of the personal and address information provided by individuals. This API plays a crucial role in ensuring trust, accuracy, and compliance in various industries. It primarily focuses on two key aspects: identity verification and address verification. By interacting with multiple databases and data sources, this API checks if the information submitted by individuals matches what's officially recorded. It categorizes the results into True/False helping organizations make informed decisions and protect against identity fraud.
Key Features and Functionalities of this API Include:
- Identity Verification: The API verifies personal details such as full name, date of birth, national ID, and gender. It assesses the accuracy of this information against official records, providing a clear indication of the level of match.
- Address Verification: It confirms the accuracy of address details, including house number, city, state, postal code, and more. This is vital for ensuring that deliveries go to the correct locations and for address-based verification in various services.
- Result Categorization: The API categorizes the verification results into "Full Match" for complete accuracy, "Partial Match" for partial accuracy, and "No Match" when the information provided doesn't align with official records.
- Identity Protection: It plays a crucial role in safeguarding individuals from identity theft and fraudulent activities. By confirming identity information, it helps prevent unauthorized access to sensitive services.
- Business Trust: For organizations, the API ensures that they can trust their customers. It's particularly important in industries like banking, where accurate identity verification is essential for granting financial services.
- Compliance: In regulated industries like finance and healthcare, the API helps businesses adhere to strict compliance requirements by verifying customer information against authoritative sources.
The Global Verification Standard API is a versatile tool that enhances trust, accuracy, and compliance for businesses and individuals alike. By checking and confirming personal and address information, it contributes to secure, efficient, and compliant operations across various industries.
Country | Alpha 2 Country Code |
|---|---|
Argentina | AR |
Brazil | BR |
Mexico | MX |
Indonesia | ID |
South Africa | ZA |
Nigeria | NG |
Kenya | KE |
Philippines | PH |
Thailand | TH |
Malaysia | MY |
United Kingdom | GB |
United States of America | US |

API Overview:
The Verification API enables the validation of various personal data inputs, including firstName, lastName, dateOfBirth, addressLine1, city, state, postalCode, and nationalIdNo. Each input is cross-referenced against authorized sources to determine a match or no-match status.
Authorization:
Access to this API is granted via an Authorization Token, ensuring secure and authenticated access for authorized users.
The API expects the following input in the request payload:
Parameter | Type | Description | Required/Optional |
|---|---|---|---|
service | string | Service field will be KYC for all countries | Required |
countryCode | string | User must enter alpha 2 country codes | Required |
firstName | string | First name of end user | Required |
lastName | string | Last name of end user | Required |
dateOfBirth | string | Date of birth of end user, must be in format yyyy-mm-dd | Required |
addressLine1 | string | Residential address of end user, should include details such as house number and street name/number | Required |
city | string | City of residence of end user | Optional |
state | string | State of residence of end user | Optional |
postalCode | string | Postal code/Zip code of end user's permanant address | Optional |
identityFields | object | This object will include fields like national ID, Phone Number and Email address | Optional |
nationalIdNo | string | National ID number of End User e.g SSN for USA. | Optional |
phoneNo | string | Phone number of end User (No Country Code needed at Prefix) | Optional |
emailAddress | string | email address of end user | Optional |
consent | boolean | Consent of end user to query his personal information against authorized data source User must Opt-in (Consent field must be True) in order to Run KYC Checks | Required |
Parameter | Description | Data Type |
|---|---|---|
countryCode | Alpha 2 Country Code, This will show the country for which data has been queried | string |
service | Service which is used to perform the check | string |
searchStatus | This field will show whether the search is successful or not for a particular individual | string |
reliabilityStatus | Shows the reliability of the search, reliablility status can be 10, 20, 30 with 10 being most reliable and 30 being least reliable | string |
verificationResult | This object will contain all the input fields against which search has been made | object |
firstName | The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources. | boolean |
lastName | The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources. | boolean |
dateOfBirth | The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources. | boolean |
addressLine1 | The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources. | boolean |
city | The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources. | boolean |
state | The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources. | boolean |
postalCode | The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources. | boolean |
nationaIdNo | The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources. | boolean |
phoneNo | The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources. | boolean |
emailAddress | The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources. | boolean |
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!