PAN KYC ID link status

Introduction

Our PAN-KYC ID Linking Status Check API offers a quick and reliable way to check whether a Permanent Account Number (PAN) is linked to an KYC ID. Essential for adhering to regulatory requirements, this API provides a simple method for users to verify linking status, ensuring compliance with Indian tax regulations. It's an invaluable tool for individuals and organizations needing to confirm the association between PAN and KYC ID efficiently.

API details

Endpoint

POST https://api.signzy.app/api/v3/pan/kycIdLinkStatus

POST https://api-preproduction.signzy.app/api/v3/pan/kycIdLinkStatus

Request Headers

Name	Value	Required	Description
Content-Type	application/json	Mandatory	The type of content that the request body contains.
Authorization	XXXXXXXXXXXXXXX	Mandatory	An authentication token to authorize the request. Reach out to the Signzy support team to get one created.

Request body parameters

Parameter	Data Type	Description	Required
panNumber	string	The PAN (Permanent Account Number) to be verified.	Mandatory
kycId	string	The KYC Id Number	Mandatory

{
    "panNumber": "",
    "kycId": ""
}

Code samples

curl --location 'https://api-preproduction.signzy.app/api/v3/pan/kycIdLinkStatus' \
--header 'Content-Type: application/json' \
--header 'Authorization: <Auth Key>' \
--data '{
    "panNumber": "ABCDE0989A",
    "kycId": "XXXXXXXX1889"
}'

Response body parameters

Parameter	Data Type	Description
result	Object	Contains the linking status result.
result.linked	Boolean	Indicates if the PAN is linked to the given KYC ID. true if provided PAN and KYC ID is linked else false.
result.kycId	String	The masked KYC ID linked to the PAN in the format "XXXX-XXXX-0000"
result.message	String	A message describing the verification result. Possible responses are: "Linked" and "Not Linked".
result.code	String	A code representing the verification status. The possible values are: Empty String when PAN - KYC ID is invalid EF40124 when PAN - KYC ID is linked, EF40125 when PAN - KYC ID is not linked.

// When pan and aadhaar is linked.
{
    "result": {
        "message": "Linked",
        "linked": true,
        "kycId": "XXXX-XXXX-1234",
        "code": "EF40124"
    },
    "reason": "REQUEST_SUCCESSFUL",
    "code": "S001"
}
// When pan and aadhaar is not linked.
{
    "result": {
        "message": "Not Linked",
        "linked": false,
        "kycId": "",
        "code": "EF40125"
    },
    "reason": "REQUEST_SUCCESSFUL",
    "code": "S001"
}

Contact Us for Any Assistance

If you have any questions or need assistance, please reach out to our customer support team. You can contact us via email at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!