PAN Details from KRA

4 min

Introduction

This API is designed to help businesses and financial institutions to verify customer identities and perform due diligence checks quickly and efficiently. API provides a range of endpoints to perform various operations, such as fetching PAN details, uploading documents, and more. One of the key endpoints available on the API is the kraservices endpoint, which allows patrons to fetch their PAN details from the KRA (KYC Registration Agency) database using their PAN number, date of birth, and KRA provider credentials. This document provides details on how to use the kraservices endpoint, including the required parameters, headers, and response format.

Sample CURL

curl --request POST \
  --url https://signzy.tech/api/v2/patrons/...patronID.../kraservices \
  --header 'Accept: */*' \
  --header 'Accept-Language: en-US,en;q=0.8' \
  --header 'Authorization: <Access-Token>' \
  --header 'content-type: application/json' \
  --data '{"task":"fetchPanDetails","essentials":{"panNumber":"...PAN Number...","dob":"...Date Of Birth...","credentials":{"kraProvider":"...KRA Provider...","username":"...username...","password":"...password...","posCode":"...posCode..."}}}'

Parameter	Type	Required	Description
patronID	string	Yes	The ID of the patron whose PAN details need to be fetched
task	string	Yes	The task to be performed, which in this case is "fetchPanDetails"
panNumber	string	Yes	The PAN number of the patron
dob	string	Yes	The date of birth of the patron in YYYY-MM-DD format
kraProvider	string	Yes	The KRA provider for which the credentials are being used
username	string	Yes	The username for the KRA provider
password	string	Yes	The password for the KRA provider
posCode	string	Yes	The Point of Service (POS) code for the KRA provider

Sample API Response

"result": {
        "panRegistrationDetails": {
            "panNumber": "...PAN Number...",
            "name": "...Name...",
            "applicationStatusCode": "...application status code...",
            "kra": "...kra...",
            "applicationStatus": "...application status...",
            "updateStatus": "...update status...",
            "kycMode": "...kyc mode...",
            "ipv": "...YES/NO...",
            "totalRecords": "...total records...",
            "holdDeactivateRemarks": "...hold deactivate remarks...",
            "updateRemarks": "...update remarks...",
            "entryDate": "...entry date...",
            "modificationDate": "...modification date...",
            "statusUpdateDate": "...status last updated date"
        },
        "kraDataFromPan": {
            "panNumber": "...pan number...",
            "name": "...name...",
            "gender": "...gender...",
            "fatherName": "...father name...",
            "nationality": "...nationality...",
            "kra": "...kra...",
            "mobileNumber": "...mobile number...",
            "dob": "...date of birth...",
            "email": "...email...",
            "poa": {
                "proofType": "...proof type...",
                "proofTypeCode": "...proof type code...",
                "number": "...number...",
                "state": "...state...",
                "stateCode": "...state code...",
                "address": "...address...",
                "splitAddress": {
                    "district": [
                        "...district..."
                    ],
                    "state": [
                        [
                            "...state...",
                            "...state code..."
                        ]
                    ],
                    "city": [
                        "...city..."
                    ],
                    "pincode": "...pincode...",
                    "country": [
                        "...country...",
                        "...country code..."
                    ],
                    "addressLine": "...address..."
                },
                "country": "...country...",
                "countryCode": "...3 digit country code..."
            },
            "cPoa": {
                "proofType": "...proof type...",
                "proofTypeCode": "...proof type code...",
                "sameAsPoa": "... Yes/No ...",
                "number": "...number...",
                "state": "...state...",
                "stateCode": "...state code...",
                "address": "...address...",
                "splitAddress": {
                    "district": [
                        "...district..."
                    ],
                    "state": [
                        [
                            "...state...",
                            "...state code..."
                        ]
                    ],
                    "city": [
                        "...city..."
                    ],
                    "pincode": "...pin code...",
                    "country": [
                        "...country ISO 2 code...",
                        "...country ISO 3 code...",
                        "...country..."
                    ],
                    "addressLine": "...address..."
                },
                "country": "...country...",
                "countryCode": "...country code..."
            },
            "incomeSlab": "...income slab...",
            "residentStatus": "...resident status...",
            "maritalStatus": "...marital status...",
            "status": "...status...",
            "applicationStatusCode": "...application status code...",
            "kycMode": "...kyc mode...",
            "branchCode": "...branch code...",
            "politicalConnection": "...political connection...",
            "statusDate": "...status date..."
        }
    }
}

Parameter	Description
panRegistrationDetails.panNumber	The PAN number of the patron
panRegistrationDetails.name	The name of the patron
panRegistrationDetails.applicationStatusCode	The application status code
panRegistrationDetails.kra	The KRA code
panRegistrationDetails.applicationStatus	The application status
panRegistrationDetails.updateStatus	The update status
panRegistrationDetails.kycMode	The KYC mode
panRegistrationDetails.ipv	Whether IPV (In-Person Verification) was done or not
panRegistrationDetails.totalRecords	The total number of records
panRegistrationDetails.holdDeactivateRemarks	Remarks for holding/deactivating the PAN
panRegistrationDetails.updateRemarks	Remarks for updating the PAN
panRegistrationDetails.entryDate	The date of PAN entry
panRegistrationDetails.modificationDate	The date of PAN modification
panRegistrationDetails.statusUpdateDate	The date when the status was last updated
kraDataFromPan.panNumber	The PAN number of the patron
kraDataFromPan.name	The name of the patron
kraDataFromPan.gender	The gender of the patron
kraDataFromPan.fatherName	The name of the patron's father
kraDataFromPan.nationality	The nationality of the patron
kraDataFromPan.kra	The KRA code
kraDataFromPan.mobileNumber	The mobile number of the patron
kraDataFromPan.dob	The date of birth of the patron
kraDataFromPan.email	The email address of the patron
kraDataFromPan.dob	The proof of address details of the patron
kraDataFromPan.cPoa	The correspondence proof of address details of the patron
kraDataFromPan.incomeSlab	The income slab of the patron
kraDataFromPan.residentStatus	The resident status of the patron
kraDataFromPan.maritalStatus	The marital status of the patron
kraDataFromPan.status	The status of the patron
kraDataFromPan.applicationStatusCode	The application status code
kraDataFromPan.kycMode	The KYC mode
kraDataFromPan.branchCode	The branch code of the patron
kraDataFromPan.politicalConnection	The political connection of the patron
kraDataFromPan.statusDate	The date of status update