Phone KYC - Phone to Income
Introduction:
The Income Details Retrieval API assists clients in obtaining their users' income details efficiently. By consuming a customer's Phone Number, PAN, and Name, this API provides estimates of the user's income.
Key Features
- Income Estimate: The API retrieves an estimate of the user's income based on inputs such as Phone Number, PAN, and Name.
Applications
- Pre-Filling Use Cases: This API seamlessly integrates into pre-filling use cases, offering streamlined retrieval of income details for various processes.
Conclusion
In summary, the Income Details Retrieval API offers a convenient solution for clients to access estimates of their users' income using Phone Number, PAN, and Name inputs. Its seamless application across pre-filling use cases enhances efficiency in income verification processes.
Sample cURL:
curl --location 'https://api.signzy.app/api/v3/phonekyc/phone-to-income' \
--header 'Content-Type: application/json' \
--header 'Authorization: <auth token>' \
--data '{
"phoneNumber": "9422025673",
"pan": "AGIPN1749B",
"firstName": "SHARAD",
"lastName": "NALAWAD",
"dob": "1977-01-15",
"address": "FLAT NO RASIKA TOWER MADHA RAOD KURDWADI LAUL-MH",
"pincode": "413208"
}'Input Parameters:
Parameter | Type | Description | Mandatory/Optional |
|---|---|---|---|
phoneNumber | String | Phone Number of the Individual | Mandatory |
firstName | String | First Name of the Individual | Mandatory |
lastName | String | Last Name of the Individual | Optional |
pan | String | PAN Number of the Individual | Optional |
dob | String | DOB of the Individual | Mandatory |
address | String | Address of the Individual | Mandatory |
pincode | String | Pincode of the Individual | Mandatory |

Sample Response:
{
"response": {
"name": "SHARAD",
"phone": "9422025673",
"address": {
"addressType": [
"H"
],
"address": "FLAT NO RASIKA TOWER MADHA RAOD KURDWADI LAUL-MH",
"state": "MH",
"pincode": "413208"
},
"dob": "1977-01-15",
"id": "AGIPN1749B",
"incomeNewCustomer": "40121",
"incomeExistingCustomer": "60412"
}
}Output Parameters:
Key | Type | Description |
|---|---|---|
response | Object | The main object contains response data. |
response.name | string | Name of the Individual |
response.phone | String | Phone Number of the Individual |
response.address | Object | contains the address object |
response.address.addressType | Array | Contains the Type of Address. Ex: Home (H), Office (O) etc.. |
response.address.address | String | Address of the Individual |
response.address.state | String | State |
response.address.pincode | String | Pincode |
response.dob | String | DOB of the Individual |
response.id | String | Govt ID of the Individual |
response.incomeNewCustomer | String | Income New Customer |
response.incomeExistingCustomer | String | Income Existing Customer |
Status Codes:
{
"response": {
"name": "SHARAD",
"phone": "9422025673",
"address": {
"addressType": [
"H"
],
"address": "FLAT NO RASIKA TOWER MADHA RAOD KURDWADI LAUL-MH",
"state": "MH",
"pincode": "413208"
},
"dob": "1977-01-15",
"id": "AGIPN1749B",
"incomeNewCustomer": "40121",
"incomeExistingCustomer": "60412"
}
}