PAN Comprehensive Plus

Endpoint Overview

POST /api/v1/pan/pan-comprehensive-plus

Description

The PAN Comprehensive Plus API provides detailed information about an individual's Permanent Account Number (PAN) card. This endpoint retrieves comprehensive personal details including the cardholder's name, father's name, address, contact information, date of birth, gender, and PAN card status. It also verifies whether the PAN is linked to Aadhaar and validates the date of birth information.

Key Benefits

Complete PAN verification with extensive personal details in a single API call

Verification of Aadhaar linkage status to ensure PAN validity

Access to structured address information for address verification processes

Retrieval of contact details (email and phone) for enhanced KYC processes

Use Cases

Financial Services

Insurance

Fintech

Customer onboarding for banking and financial institutions

KYC verification for loan and credit card applications

Identity verification for investment accounts and trading platforms

Technical Implementation

Authentication

All API requests require authentication using a JWT Bearer token. Authentication follows these steps:

Obtain API Credentials: Register with Surepass to receive your API key.

Generate JWT Token: Use your API key to generate a JWT token.

Include in Requests: Add the token to the Authorization header as Bearer TOKEN.

Different authentication tokens are used for sandbox and production environments:

Sandbox: https://sandbox.surepass.io

Production: https://kyc-api.surepass.io

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token authentication using JWT
Content-Type	Yes	application/json

Request Body

Parameter	Type	Required	Description
id_number	String	Yes	PAN Number to be verified (e.g., "AVVPA1234L")

Example Request

{
    "id_number": "AVVPA1234L"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the verification results
data.client_id	String	Unique identifier for the verification request
data.pan_number	String	PAN number that was verified
data.pan_details	Object	Comprehensive details associated with the PAN
data.less_info	Boolean	Indicates if limited information was returned
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the API call was successful
message	String	Human-readable status message
message_code	String	Machine-readable status code

pan_details Object

Parameter	Type	Description
full_name	String	Complete name of the PAN holder
full_name_split	Array	Name split into [First Name, Middle Name, Last Name]
masked_aadhaar	String	Partially masked Aadhaar number linked to the PAN
address	Object	Structured address information
email	String	Email address of the PAN holder
phone_number	String	Mobile number of the PAN holder
gender	String	Gender of the PAN holder (e.g., "M" for Male)
dob	String	Date of birth in YYYY-MM-DD format
input_dob	String	Input date of birth (if provided) in YYYY-MM-DD format
aadhaar_linked	Boolean	Whether the PAN is linked to Aadhaar
dob_verified	Boolean	Whether the date of birth has been verified
dob_check	Boolean	Result of date of birth validation check
category	String	Category of the PAN (e.g., "person", "company")
father_name	String	Name of the PAN holder's father

address Object

Parameter	Type	Description
line_1	String	House/building number
line_2	String	Colony/society name
street_name	String	Street name
zip	String	Postal code/PIN code
city	String	City name
state	String	State name
country	String	Country name
full	String	Complete address as a single string

Example Successful Response

{
    "data": {
        "client_id": "pan_comprehensive_plus_SiCaniPfvZzkbsJgUwfn",
        "pan_number": "AVVPA1234L",
        "pan_details": {
            "full_name": "KARAN ARORA",
            "full_name_split": [
                "KARAN",
                "",
                "ARORA"
            ],
            "masked_aadhaar": "XXXXXXXX1234",
            "address": {
                "line_1": "",
                "line_2": "",
                "street_name": "",
                "zip": "",
                "city": "",
                "state": "",
                "country": "",
                "full": ""
            },
            "email": null,
            "phone_number": null,
            "gender": "M",
            "dob": "1992-09-30",
            "input_dob": null,
            "aadhaar_linked": true,
            "dob_verified": false,
            "dob_check": false,
            "category": "person",
            "father_name": "RAMESH"
        },
        "less_info": false
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid PAN

Authentication Error

{
    "data": null,
    "status_code": 422,
    "message": "Invalid PAN",
    "success": false,
    "message_code": null
}

The provided PAN number does not match the required format or contains invalid characters.

Integration Best Practices

Security Recommendations

Store API keys securely and never expose them in client-side code

Implement proper error handling to avoid exposing sensitive information

Use HTTPS for all API communications to ensure data encryption

Implement rate limiting on your side to prevent abuse of the API

User Experience Guidelines

Validate PAN format client-side before making API calls to improve response times

Implement proper loading states while waiting for API responses

Display clear error messages to users when verification fails

Consider caching verified PAN details (securely) to reduce redundant API calls

Code Samples

cURL

Python

Node.js

Related APIs

PAN Basic Verification: Provides basic verification of PAN card details

PAN OCR: Extracts information from PAN card images

Aadhaar Verification: Verifies Aadhaar card details

Address Verification: Validates address information against official records

Compliance and Legal Considerations

This API handles personally identifiable information (PII) and is subject to data protection regulations. Ensure you have proper consent from users before verifying their PAN details. The use of this API should comply with the Income Tax Department of India's regulations regarding PAN verification. Store and process the retrieved data in accordance with applicable privacy laws.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/pan/pan-comprehensive-plus' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "id_number": "AVVPA1234L" }'

{ "data": { "client_id": "pan_comprehensive_plus_SiCaniPfvZzkbsJgUwfn", "pan_number": "AVVPA1234L", "pan_details": { "full_name": "KARAN ARORA", "full_name_split": [ "KARAN", "", "ARORA" ], "masked_aadhaar": "XXXXXXXX1234", "address": { "line_1": "", "line_2": "", "street_name": "", "zip": "", "city": "", "state": "", "country": "", "full": "" }, "email": null, "phone_number": null, "gender": "M", "dob": "1992-09-30", "input_dob": null, "aadhaar_linked": true, "dob_verified": false, "dob_check": false, "category": "person", "father_name": "RAMESH" }, "less_info": false }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

PAN Comprehensive Plus

PAN Comprehensive Plus#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

pan_details Object#

address Object#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

PAN Comprehensive Plus

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

pan_details Object

address Object

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples