PAN Details from KRA
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 |