PAN Advanced V2

Endpoint Overview

POST /api/v1/pan/pan-adv-v2

Description

The PAN Advanced V2 API provides comprehensive verification and information retrieval for Permanent Account Number (PAN) cards in India. This endpoint allows you to validate a PAN number and retrieve detailed information about the PAN holder, including their full name, title, PAN status, Aadhaar seeding status, and PAN card category. This API is essential for KYC (Know Your Customer) processes, identity verification, and regulatory compliance.

Key Benefits

Comprehensive Verification: Validate PAN cards and retrieve detailed holder information in a single API call

Aadhaar Linkage Status: Verify if the PAN is linked with Aadhaar as per government regulations

Entity Type Classification: Identify the category of the PAN holder (person, company, firm, etc.)

Reliable Data Source: Direct verification against official government records

Use Cases

Financial Services

Fintech

Corporate

Customer onboarding for banking and financial institutions

KYC verification for loan applications and account openings

Regulatory compliance for financial transactions

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 Card Number to be verified (e.g., "EKRPR1234F")

Example Request

{
    "id_number": "EKRPR1234F"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains all the PAN verification details
data.client_id	String	Unique client identifier for the request
data.pan_number	String	PAN (Permanent Account Number) of the person
data.full_name	String	Full name of the PAN holder
data.title	String	Title or salutation (e.g., Shri, Smt, M/s)
data.full_name_split	Array	Full name split into components (first name, middle name, last name)
data.pan_status	String	PAN status code (E: Existing and valid PAN)
data.pan_status_desc	String	Description of PAN status
data.aadhaar_seeding_status	String	Aadhaar seeding status code (Y: Seeded, R: Not seeded, NA: Not applicable)
data.aadhaar_seeding_status_desc	String	Description of Aadhaar seeding status
data.pan_modified_date	String/null	Date when PAN was last modified (if available)
data.category	String	Category of the entity (person, company, firm, etc.)
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the API call was successful
message	String/null	Additional message (if any)
message_code	String	Code indicating the status of the request

Example Successful Response

{
    "data": {
        "client_id": "pan_advanced_v2_svRDkKzelWrlDyHnonNO",
        "pan_number": "EKRPR1234F",
        "full_name": "VISHAL RATHORE",
        "title": "Shri",
        "full_name_split": [
            "VISHAL",
            "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": null,
        "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 end to prevent abuse

User Experience Guidelines

Validate PAN format client-side before making API calls

Display clear error messages to users when verification fails

Implement a loading state during API calls to indicate processing

Consider caching verified PAN details (in compliance with data protection laws)

Code Samples

cURL

Python

Node.js

Related APIs

PAN Basic Verification API: Simple PAN validation without detailed information

Aadhaar Verification API: Verify Aadhaar details and authentication

Business Verification API: Comprehensive business entity verification

Document OCR API: Extract information from PAN card images

Compliance and Legal Considerations

This API accesses government-issued identification information and is subject to regulatory requirements. Usage must comply with the Information Technology Act, 2000 and the Prevention of Money Laundering Act (PMLA) guidelines. Ensure you have proper consent from users before verifying their PAN details and maintain appropriate data protection measures. Data retrieved should be stored securely and in compliance with applicable data protection laws.

{ "data": { "client_id": "pan_advanced_v2_svRDkKzelWrlDyHnonNO", "pan_number": "EKRPR1234F", "full_name": "VISHAL RATHORE", "title": "Shri", "full_name_split": [ "VISHAL", "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": null, "category": "person" }, "status_code": 200, "success": true, "message": null, "message_code": "success" }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

PAN Advanced V2

PAN Advanced V2#

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 V2

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