Phone KYC - Registered Address

Introduction

The Phone KYC - Registered Address API assists clients in understanding their users' demographic profiles. By consuming a customer's Phone Number and Name, this API provides the user's registered address. The result includes up to 5 alternate addresses of the user. The detailed address information enables clients to profile users based on the Pincode or offer them convenient options for delivery or communication addresses.

Key Features

Registered Address Retrieval: The API retrieves the registered address of the user based on inputs such as Phone Number and Name.
Alternate Addresses: Additionally, it provides up to 5 alternate addresses associated with the user.

Applications

Pre-Filling Use Cases: Seamlessly integrates into pre-filling use cases, offering streamlined retrieval of address details for various processes.
Profiling Use Cases: Enables clients to profile users based on Pincode or offer convenient delivery or communication address options.

Conclusion

In summary, the Phone KYC - Registered Address API offers a convenient solution for clients to access their users' registered addresses and alternate addresses using Phone Number and Name inputs. Its seamless application across pre-filling and profiling use cases enhances efficiency in demographic profiling and address verification processes.

Sample cURL:

curl --location 'https://api.signzy.app/api/v3/phonekyc/registeredaddress' \
--header 'Content-Type: application/json' \
--header 'Authorization: <auth token>' \
--data '{
    "phoneNumber": "9502444055",
    "pan": "BEVPD4804B",
    "firstName": "RAMBABU",
    "lastName": "DARA"
}'

Input Parameters:

Parameter	Type	Description	Mandatory/Optional
phoneNumber	String	The phone number of the individual.	Mandatory
pan	String	The PAN (Permanent Account Number) of the individual.	Optional
firstName	String	first name of the Individual.	Mandatory
lastName	String	last name of the Individual.	Optional

Sample Response:

{
    "response": {
        "address": [
            {
                "Seq": "1",
                "ReportedDate": "2023-11-30",
                "Address": "SANTHAKAVITI MANDAL MANDARADA VILLAGE  SRIKAKULAM DIST  A P SRIKAKULAM",
                "State": "AP",
                "Postal": "532123"
            },
            {
                "Seq": "2",
                "ReportedDate": "2023-11-30",
                "Address": "SRIKAKULAM ANDHRA PRADESH 532123",
                "State": "AP",
                "Postal": "532123",
                "Type": "Primary"
            },
            {
                "Seq": "3",
                "ReportedDate": "2023-05-31",
                "Address": "S/O D APPALARAMULU LATE MANDARADA COLO NY MANDARADA VILL PO  SANTAKAVITI MD S KLM DIST  MANDARADA",
                "State": "AP",
                "Postal": "532123",
                "Type": "Permanent"
            },
            {
                "Seq": "4",
                "ReportedDate": "2022-06-16",
                "Address": "S/O D APPALARAMULU LATE MANDARADA COLO N MANDARADA VILL PO  SANTAKAVITI MD SK LM MANDARADA",
                "State": "AP",
                "Postal": "532123",
                "Type": "Permanent"
            },
            {
                "Seq": "5",
                "ReportedDate": "2020-12-02",
                "Address": "SANTHAKAVITI MANDAL MANDARADA VILLAGE  SRIKAKULAM",
                "State": "AP",
                "Postal": "532123",
                "Type": "Rents,Primary"
            }
        ],
        "personalInfo": {
            "name": "RAMBABU DARA ",
            "gender": "Male",
            "dateOfBirth": "1987-01-01"
        }
    }
}

Output Parameters:

Key	Type	Description
response	Object	The main object contains response data.
response.address	Array	An array of registered addresses of the individual.
response.personalInfo	Object	Object containing personal information.
response.personalInfo.name	String	The name of the individual.
response.personalInfo.gender	String	The gender of the individual.
response.personalInfo.dateOfBirth	String	The date of birth of the individual.

Status Codes:

Code	Message
200	Success
400	Bad Request
404	Not Found
409	Upstream Error
500	Internal Server Error