PAN Advanced

Endpoint Overview

POST /api/v1/pan/pan-adv

Description

The PAN Advanced API provides comprehensive verification and detailed information about a Permanent Account Number (PAN) in India. This API validates the PAN number and returns extensive details including the holder's full name, PAN status, Aadhaar seeding status, gender, and category information. It's designed to help businesses perform thorough KYC verification and identity validation with minimal input requirements.

Key Benefits

Comprehensive PAN verification with detailed holder information

Verification of PAN validity status and Aadhaar seeding status

Name parsing into first, middle, and last name components for easier data processing

Real-time verification against official government records

Use Cases

Financial Services

FinTech

Corporate

Customer onboarding for banking and financial institutions

KYC verification for loan and credit card applications

Investment account setup and verification

Field Value Reference Guide

title

The title field can have the following values:

Smt – Common prefix for women (equivalent to Mrs.)

Shri – Common prefix for men (equivalent to Mr.)

M/s – Prefix used for business entities or partnerships

pan_status

The pan_status field can have the following values:

Code	Meaning
E	Existing and valid PAN
F	Fake PAN
X	Deactivated PAN
D	Deleted PAN
N	Invalid PAN
EA	Amalgamation
EC	Acquisition
ED	Death
EI	Existing and Valid but event marked as “Dissolution” in ITD database
EL	Existing and Valid but event marked as “Liquidated” in ITD database
EM	Existing and Valid but event marked as “Merger” in ITD database
EP	Existing and Valid but event marked as “Partition” in ITD database
ES	Existing and Valid but event marked as “Split” in ITD database
EU	Existing and Valid but event marked as “Under Liquidation” in ITD database
I	Inoperative

aadhaar_seeding_status

The aadhaar_seeding_status field can have the following values:

Y – Aadhaar is seeded against the PAN

R – Aadhaar is not seeded

NA – Not applicable (typically for company PANs)

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., "EKRPR7936Z")

Example Request

{
    "id_number": "EKRPR7936Z"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for the response data
data.client_id	String	Unique identifier for the verification request
data.pan_number	String	PAN Card number that was verified
data.full_name	String	Full name of the PAN holder
data.title	String	Title of the PAN holder (e.g., "Shri")
data.full_name_split	Array	Name components [First Name, Middle Name, Last Name]
data.pan_status	String	Status code of the PAN (e.g., "E" for existing)
data.pan_status_desc	String	Detailed description of the PAN status
data.aadhaar_seeding_status	String	Aadhaar seeding status code (e.g., "Y" for successful)
data.aadhaar_seeding_status_desc	String	Detailed description of Aadhaar seeding status
data.pan_modified_date	String	Date when PAN was last modified (YYYY-MM-DD format)
data.category	String	Category of the PAN holder (e.g., "person", "company")
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the API call was successful
message	String	Additional message (null if successful)
message_code	String	Code indicating the status of the request

Example Successful Response

{
    "data": {
        "client_id": "pan_advanced_wykZaletbbHVqwcwLVkx",
        "pan_number": "RKRPR7936F",
        "full_name": "AMAR SINGH RATHORE",
        "title": "Shri",
        "full_name_split": [
            "AMAR",
            "SINGH",
            "RATHORE"
        ],
        "pan_status": "E",
        "pan_status_desc": "EXISTING AND VALID",
        "aadhaar_seeding_status": "Y",
        "aadhaar_seeding_status_desc": "Aadhaar Seeding is Successful",
        "pan_modified_date": "2018-11-05",
        "category": "person"
    },
    "status_code": 200,
    "success": true,
    "message": null,
    "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

Implement rate limiting on your side to prevent abuse

User Experience Guidelines

Validate PAN format client-side before making API calls

Implement appropriate loading states during API calls

Display clear error messages to users when verification fails

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

Code Samples

cURL

Python

Node.js

Related APIs

PAN Basic API: Provides basic PAN verification with limited details

PAN OCR API: Extracts PAN details from uploaded PAN card images

PAN with Face Match API: Verifies PAN details with facial recognition

Compliance and Legal Considerations

The PAN Advanced API accesses government data and must be used in compliance with Indian data protection regulations. Ensure you have proper consent from users before verifying their PAN details. The data returned should be handled securely and in accordance with privacy laws. This API should only be used for legitimate KYC and verification purposes as permitted by law.

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-adv' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "id_number": "EKRPR7936Z" }'

{ "data": { "client_id": "pan_advanced_wykZaletbbHVqwcwLVkx", "pan_number": "RKRPR7936F", "full_name": "AMAR SINGH RATHORE", "title": "Shri", "full_name_split": [ "AMAR", "SINGH", "RATHORE" ], "pan_status": "E", "pan_status_desc": "EXISTING AND VALID", "aadhaar_seeding_status": "Y", "aadhaar_seeding_status_desc": "Aadhaar Seeding is Successful", "pan_modified_date": "2018-11-05", "category": "person" }, "status_code": 200, "success": true, "message": null, "message_code": "success" }

PAN Advanced

PAN Advanced#

Description#

Use Cases#

Field Value Reference Guide#

title#

pan_status#

aadhaar_seeding_status#

category#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

PAN Advanced

Description

Use Cases

Field Value Reference Guide

title

pan_status

aadhaar_seeding_status

category

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples