PAN Aadhaar Link status API
Introduction
The Business PAN Aadhaar Link Status API provided by Signzy Technologies enables you to check whether a PAN (Permanent Account Number) is linked to the corresponding Aadhaar number of the same individual. This API is useful for businesses that need to verify the identity of their customers or users, and ensure compliance with government regulations.
To use this API, you need to send a POST request to the API endpoint with the required input parameters. The API will return a response indicating whether the PAN and Aadhaar are linked or not, along with a message and a code for reference.
Use Cases
The Business PAN Aadhaar Link Status API provided by Signzy Technologies can be used in various scenarios, such as:
- KYC Verification: Businesses can use this API to verify the identity of their customers by checking whether their PAN and Aadhaar are linked or not. This can help prevent fraud and ensure compliance with KYC (Know Your Customer) regulations.
- Account Opening: Banks and financial institutions can use this API to verify the identity of their customers while opening new accounts or providing financial services. This can help streamline the onboarding process and reduce the risk of identity theft.
- Government Services: Government agencies can use this API to verify the identity of citizens while providing various services, such as issuing passports, driving licenses, or voting cards. This can help improve the efficiency and accuracy of public services.
- Compliance Reporting: Companies can use this API to generate reports and audit trails for compliance purposes, such as tax filings, statutory filings, or regulatory filings. This can help ensure accurate and timely reporting of financial and non-financial information.
Overall, the Business PAN Aadhaar Link Status API can be a valuable tool for businesses and organizations that need to verify the identity of individuals in a secure and reliable manner. By integrating this API into their systems and workflows, they can enhance their compliance, reduce risk, and improve customer experience.
API description
API Endpoint's
Identity Object
POST https://preproduction.signzy.tech/api/v2/patrons/<patron-id>/identitiesPOST https://signzy.tech/api/v2/patrons/<patron-id>/identitiesHeaders
Key | Value |
|---|---|
Authorization | access token (returned as id field of login request) |
Content-type | application/json |
Request Data
{
"type": "individualPan/businessPan",
"email": "[email protected]",
"callbackUrl": "https://your-domain.com/your-callback-system",
"images": []
}PARAMETERS | DESCRIPTION | TYPE | VALUE (COMPULSORY OR OPTIONAL) |
|---|---|---|---|
type | Supported type parameter for creation of Identity objects
| String | COMPULSORY |
E-mail can't be empty | String | COMPULSORY | |
callbackUrl | callbackUrl is where the data is posted on each activity performed on this Identity object. | String | COMPULSORY |
images | empty | List | COMPULSORY |
Response
{
"type": "individualPan/businessPan",
"email": "[email protected]",
"callbackUrl": "https://your-domain.com/your-callback-system",
"images": [
],
"autoRecognition": [],
"verification": [],
"forgeryCheck": [],
"accessToken": "..access-token-for-the-snoop-request..",
"id": "..itemId-for-the-snoop-request....",
"patronId": "..your-id-into-signzy-system-(userId-returned-from-the-login-call).."
}
Snoops
POST https://preproduction.signzy.tech/api/v2/snoopsPOST https://signzy.tech/api/v2/snoopsHeaders
Key | Value |
|---|---|
Authorization | access token (returned as id field of login request) |
Content-type | application/json |
Request Data
{
"service": "Identity",
"itemId": "<Identity-object-id>",
"task": "panAadhaarLinkStatus",
"accessToken": "<Identity-access-token>",
"essentials": {
"number": "<PAN-as-mentioned-on-the-card>",
"uid": "..Aadhaar Number..."
}
}Response
{
"result": {
"linked" : "true/false",
"uid" : "..uid..." // uid will have first 8 digits masked
}
}Details of the response properties
Property | Example Value | Description |
|---|---|---|
linked | true/false | A boolean value indicating whether the PAN is linked to the given Aadhaar number. |
uid | XXXX-XXXX-5552 | A 12-digit unique identification number assigned to the individual's Aadhaar card. |
message | PAN is linked to given Aadhaar | A descriptive message indicating whether the PAN is linked to the given Aadhaar number. |
code | EF40124 | A unique code assigned to the API response. |
error.statusCode | 400 | A numeric status code indicating the status of the error. |
error.name | Error | A string indicating the type of error that occurred. |
error.message | PAN does not exist or incorrect | A descriptive message explaining the error that occurred. |
error.status | 400 | A numeric status code indicating the status of the error. |
Error Codes
Error Code | Description |
|---|---|
400 | The request was malformed or invalid. |
401 | The request was unauthorized. |
403 | The request was forbidden. |
404 | The requested resource was not found. |
429 | Too many requests have been made in a given amount of time. |
500 | An unexpected error occurred on the server. |
Troubleshooting
Issue | Solution |
|---|---|
Invalid or missing service parameter. | Verify that the service parameter is present in the request body and has a valid value. Refer to the API documentation for the list of valid values. |
Invalid or missing itemId parameter. | Verify that the itemId parameter is present in the request body and has a valid value. |
Invalid or missing accessToken parameter. | Verify that the accessToken parameter is present in the request body and has a valid value. |
Invalid or missing task parameter. | Verify that the task parameter is present in the request body and has a valid value. Refer to the API documentation for the list of valid values. |
Invalid or missing essentials parameter. | Verify that the essentials parameter is present in the request body and has a valid value. |
Invalid or missing name parameter in essentials. | If the name of the individual is unknown, leave this parameter blank. |
Invalid or missing number parameter in essentials. | Verify that the number parameter is present in the essentials object and contains a valid PAN number. |
Invalid or missing uid parameter in essentials. | Verify that the uid parameter is present in the essentials object and contains a valid Aadhaar number. |
Invalid fuzzy parameter in essentials. | If the value of fuzzy is set to true, the API will perform a fuzzy match to link the PAN and Aadhaar. Set this parameter to false for an exact match. |
Invalid panStatus parameter in essentials. | If the value of panStatus is set to true, the API will also return the status of the PAN card. Set this parameter to false to exclude the PAN status from the response. |
Invalid combination of PAN and Aadhaar. | Ensure that the provided PAN and Aadhaar belong to the same individual. |
Server error. | Wait for some time and try the request again later. If the issue persists, contact the API provider's support team. |
FAQ:
1) If the response is ‘linked : false’ does it simply mean that these specific PAN and Aadhaar haven’t been linked with each other? Or do we get an indication if either of them have been linked to another PAN/Aadhaar?
- The response is just true or false. Which means it's either linked or unlinked.
2) The uid in the response is the Aadhaar uid right? Will it be the same as the one we pass in the request?
- Yes that's correct, however the uid will have the first 8 digits masked, yes it will be the same as the one you pass in the request.