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 |