PAN Advanced V3

Endpoint Overview

POST /api/v1/pan/pan-adv-v3

Description

The PAN Advanced V3 API enables verification of an individual's identity by validating whether the provided name and date of birth match the official records associated with their Permanent Account Number (PAN). This API also returns the PAN card's operational status and Aadhaar seeding status, providing a comprehensive verification solution for KYC processes.

Key Benefits

Instant verification of PAN details against official government records

Comprehensive validation of name and date of birth with match status indicators

Verification of PAN operational status and Aadhaar linkage status

Reduces fraud risk and improves KYC compliance efficiency

Use Cases

Financial Services

FinTech

Insurance

Customer onboarding for banking and financial institutions

KYC verification for loan 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., "EKRPR1234F")
name	String	Yes	Full name as it appears on the PAN card
dob	String	Yes	Date of birth in "YYYY-MM-DD" format (e.g., "2000-07-25")

Example Request

{
    "id_number": "EKRPR1234F",
    "name": "deepak rathore",
    "dob": "2000-07-25"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for the verification result data
data.client_id	String	Unique identifier for the verification request
data.pan_number	String	The PAN number that was verified
data.name	String	Name of the individual as per official records
data.dob	String	Date of birth in "YYYY-MM-DD" format as per official records
data.pan_status	String	Current status of the PAN card
data.name_status	String Enum	Indicates if the provided name matches the official record ("MATCHING" or "NON-MATCHING")
data.dob_status	String Enum	Indicates if the provided DOB matches the official record ("MATCHING" or "NON-MATCHING")
data.aadhaar_seeding_status	String Enum	Indicates if the PAN is linked with Aadhaar ("Operative PAN" or "Inoperative PAN")
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

Example Successful Response

{
    "data": {
        "client_id": "pan_advanced_v3_edUkzeivGsiseWJyNcTp",
        "pan_number": "EKRPR1234F",
        "name": "Vishal Singh Rathore",
        "dob": "2001-07-25",
        "pan_status": "EXISTING AND VALID",
        "name_status": "MATCHING",
        "dob_status": "MATCHING",
        "aadhaar_seeding_status": "Operative PAN"
    },
    "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

Rotate JWT tokens periodically and implement token expiration

User Experience Guidelines

Implement real-time validation of PAN format before submission

Provide clear feedback when verification fails with specific reasons

Include a date picker with proper format guidance for DOB input

Implement progressive disclosure of verification results

Code Samples

cURL

Python

Node.js

Related APIs

PAN Basic Verification: Simpler PAN verification without name and DOB matching

PAN OCR: Extract information from PAN card images

Aadhaar Verification: Verify Aadhaar details for comprehensive KYC

Compliance and Legal Considerations

This API accesses official PAN records and must be used in compliance with applicable data protection laws. Usage should be limited to legitimate KYC and verification purposes with proper user consent. The API should not be used for mass data collection or purposes outside of identity verification.

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/pan/pan-adv-v3' \ --header 'Content-Type: application/json' \ --data-raw '{ "id_number": "EKRPR1234F", "name": "deepak rathore", "dob": "2000-07-25" }'

{ "data": { "client_id": "pan_advanced_v3_edUkzeivGsiseWJyNcTp", "pan_number": "EKRPR1234F", "name": "Vishal Singh Rathore", "dob": "2001-07-25", "pan_status": "EXISTING AND VALID", "name_status": "MATCHING", "dob_status": "MATCHING", "aadhaar_seeding_status": "Operative PAN" }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

PAN Advanced V3

PAN Advanced V3#

Description#

Use Cases#

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 V3

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples