Business PAN verification V2

Introduction

Our Business PAN Verification API offers a swift and reliable solution for authenticating Permanent Account Numbers (PAN) in India. Designed for ease of integration and accuracy, it allows businesses to verify PAN details such as name and number with a simple API call. This API is ideal for financial institutions, KYC processes, and any service requiring PAN validation. With its user-friendly interface and precise verification, it streamlines compliance and enhances customer trust.

API details

Endpoint

POST https://signzy.tech/api/v2/snoops

POST https://preproduction.signzy.tech/api/v2/snoops

Request body parameters

Parameter	Data Type	Description	Required
service	String	Specifies the type of service, here it's set to "Identity".	Mandatory
itemId	String	ID generated as part of Create Identity API call.	Mandatory
accessToken	String	The access token generated in the response of the Identity API call.	Mandatory
task	String	Defines the task to be performed, set to "verification".	Mandatory
essentials	Object	Contains essential data for PAN verification.	Mandatory
essentials.name	String	Name associated with the PAN number.	Mandatory
essentials.number	String	The PAN number to be verified.	Mandatory
essentials.fuzzy	Boolean	Option to enable fuzzy name matching. Possible values are "true" or "false". The default value is "false".	Optional
essentials.panStatus	Boolean	Indicates whether to check the status of the PAN. Possible values are "true" or "false". The default value is "false".	Optional

{
    "service": "Identity",
    "itemId": "<ID_generated_from_identity_call>",
    "accessToken": "<Token_generated_from_identity_call>",
    "task": "verification",
    "essentials": {
        "name": "<Company name>",
        "number": "<PAN number>",
        "fuzzy": "true",
        "panStatus": "true"
    }
}

Request headers

Name	Value	Required	Description
Content-Type	application/json	Mandatory	The type of content that the request body contains.

Code Samples

curl --location 'https://preproduction.signzy.tech/api/v2/snoops' \
--header 'Content-Type: application/json' \
--data '{
    "service": "Identity",
    "itemId": "<ID_generated_from_identity_call>",
    "accessToken": "<Token_generated_from_identity_call>",
    "task": "verification",
    "essentials": {
        "name": "<Company name>",
        "number": "<PAN number>",
        "fuzzy": "true",
        "panStatus": "true"
    }
}'

Response body parameters

Parameter	Data Type	Description
verified	Boolean	Indicates whether the PAN verification was successful or not.
message	String	Provides details about the verification result. The possible values are "Verification completed with positive result" or "Verification completed with negative result".
upstreamName	String	The name of the business entity as returned by the upstream data source.
panStatus	String	The status of the PAN.(Refer to PAN status codes below for possible values). This field will only be returned in cases when panStatus will sent as "true" in the request body.
panStatusCode	String	A code representing the PAN status. (Refer to PAN status codes below for possible values). This field will only be returned in cases when panStatus will sent as "true" in the request body.

{
    "service": "Identity",
    "itemId": "<ID_generated_from_identity_call>",
    "task": "verification",
    "essentials": {
        "name": "Signzy technologies",
        "number": "AAWCS3552Q",
        "fuzzy": "true",
        "panStatus": "true",
        "instance": {}
    },
    "accessToken": "<Token_generated_from_identity_call>",
    "id": "659feffa4f0ab50024659c70",
    "response": {
        "name": "Signzy technologies",
        "number": "AAWCS3552Q",
        "fuzzy": "true",
        "panStatus": "true",
        "id": 35380,
        "instance": {
            "id": "<ID_generated_from_identity_call>",
            "callbackUrl": ""
        },
        "result": {
            "verified": true,
            "message": "Verification completed with positive result",
            "upstreamName": "SIGNZY TECHNOLOGIES PRIVATE LIMITED",
            "panStatus": "VALID",
            "panStatusCode": "E"
        }
    }
}

PAN Status codes

Status code	Status
E	VALID
F	FAKE
X	DEACTIVATED
D	DELETED
N	INVALID
EA	AMALGAMATION
EC	ACQUISITION
ED	DEATH
EI	DISSOLUTION
EL	LIQUIDATED
EM	MERGER
EP	PARTITION
ES	SPLIT
EU	UNDER LIQUIDATION

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!