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"
	}
}