Phone KYC - Phone to Prefill

Introduction:

The User Prefill API simplifies the process for clients to obtain their users' prefill details. By inputting a customer's Phone Number, PAN, and Name, this API aims to deliver comprehensive information about individuals, encompassing contact details, address history, identification documents, and demographic data.

Key Features

Comprehensive Data Retrieval: The API gathers extensive information, covering contact details, address history, identification documents, and demographic data, based on the provided Phone Number, PAN, and Name inputs.

Applications

Versatile Pre-Filling Integration: This API seamlessly integrates into various pre-filling use cases, offering efficient retrieval of user details to streamline processes across different domains.

Conclusion

In conclusion, the User Prefill API presents a versatile solution for clients seeking to access their users' prefill details using Phone Number, PAN, and Name inputs. Its seamless integration into pre-filling use cases enhances efficiency across diverse processes requiring comprehensive user information.

Sample cURL:

curl --location 'https://api.signzy.app/api/v3/phonekyc/phone-prefill' \
--header 'Content-Type: application/json' \
--header 'Authorization: <auth token>' \
--data '{
    "phoneNumber": "9996889976",
    "firstName": "DARSHAN",
    "lastName": "GORDHAN",
    "pan": "ACOPY8003F"
}'

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

Sample Response:

{
    "response": {
        "alternatePhone": [
            {
                "serialNo": 1,
                "phoneNumber": "07206467571"
            },
            {
                "serialNo": 2,
                "phoneNumber": "9996889976"
            },
            {
                "serialNo": 3,
                "phoneNumber": "9831028518"
            },
            {
                "serialNo": 4,
                "phoneNumber": "03322908334"
            }
        ],
        "email": [
            {
                "serialNo": 1,
                "email": "[email protected]"
            }
        ],
        "address": [
            {
                "Seq": "1",
                "ReportedDate": "2017-11-30",
                "Address": "JINDAL LABOUR COLONY  HISAR HIND PUBLIC SCHOOLCUS AVENUE",
                "State": "WB",
                "Postal": "700017",
                "Type": "Primary"
            },
            {
                "Seq": "2",
                "ReportedDate": "2017-07-31",
                "Address": "JINDAL LABOUR COLONY  HISAR HIND PUBLIC SCHOOL",
                "State": "HR",
                "Postal": "125001"
            },
            {
                "Seq": "3",
                "ReportedDate": "2017-07-31",
                "Address": "NO P302 DARGA ROAD  DONBOSCO SCHOOL",
                "State": "WB",
                "Postal": "700017",
                "Type": "Primary"
            },
            {
                "Seq": "4",
                "ReportedDate": "2016-11-30",
                "Address": "P 302 DARGA ROAD  KOLKATA",
                "State": "WB",
                "Postal": "700017",
                "Type": "Primary"
            },
            {
                "Seq": "5",
                "ReportedDate": "2013-04-30",
                "Address": "71E/1A TILJALA ROAD  TILJALA KOLKATA",
                "State": "WB",
                "Postal": "700039"
            }
        ],
        "voterId": [
            {
                "serialNo": 1,
                "voterId": "JJM2864304"
            }
        ],
        "passport": [
            {
                "serialNo": 1,
                "passport": "J8186008"
            }
        ],
        "drivingLicense": [
            {
                "serialNo": 1,
                "drivingLicense": "WB20200653744"
            },
            {
                "serialNo": 2,
                "drivingLicense": "20141026632"
            }
        ],
        "pan": "BMIPA0801N",
        "name": {
            "fullName": "DARSHAN GORDHAN ",
            "firstName": "DARSHAN ",
            "lastName": "GORDHAN "
        },
        "income": "30081",
        "gender": "Male",
        "age": "35",
        "dob": "1989-01-01"
    }
}

Output Parameters:

Key	Type	Description
response	Object	The main object contains response data.
response.alternatePhone	Array of Objects	List of Phone Numbers associated with the user.
response.alternatePhone.serialNo	Number	Unique identifier for the alternate phone number (multiple entries possible).
response.alternatePhone.phoneNumber	String	The alternate phone number (multiple entries possible).
response.email	Array of Objects	List of Emails associated with the user.
response.email.serialNo	Number	Unique identifier for the email address (multiple entries possible).
response.email.email	String	The email address (multiple entries possible).
response.address	Array of Objects	List of Addresses associated with the user.
response.address.Seq	String	Unique identifier for the address record (might not be sequential).
response.address.ReportedDate	String	Date the address was reported (YYYY-MM-DD format).
response.address.Address	String	Full address information.
response.address.State	String	State code of the address.
response.address.Postal	String	Postal code of the address.
response.address.Type	String	Type of address (e.g., "Office", "Primary", "Permanent").
response.drivingLicense	Array of Objects	Represents the List of Driving Licenses
response.drivingLicense.serialNo	Number	Unique identifier for the driving license (multiple entries possible).
response.drivingLicense.drivingLicense	String	The driving license number (multiple entries possible).
response.voterId	Array of Objects	Represents the List of Voter Ids
response.voterId.serialNo	Number	Unique identifier for the Voter Id (multiple entries possible).
response.voterId.voterId	String	VoterId number (multiple entries possible)
response.passport	Array of Objects	Represents the List of Passports
response.passport.serialNo	Number	Unique identifier for the passport (multiple entries possible).
response.passport.passport	String	Passport Number (multiple entries possible)
response.pan	String	PAN card number of the individual.
response.name	Object
response.name.fullName	String	Full name of the individual.
response.name.firstName	String	First name of the individual.
response.name.lastName	String	Last name of the individual.
response.income	String	Reported income of the individual.
response.gender	String	Gender of the individual (e.g., "Male", "Female").
response.age	String	Age of the individual.
response.dob	String	Date of birth of the individual (YYYY-MM-DD format).

Status Codes:

{
    "error": {
        "name": "error",
        "message": "Internal Server Error",
        "status": 500,
        "reason": "ERROR",
        "type": "Internal Server Error",
        "statusCode": 500
    }
}