PAN With Details V3

Endpoint Overview

POST /api/v1/pan/pan-with-details-v3

Description

This API endpoint retrieves comprehensive details associated with a Permanent Account Number (PAN) in India. It provides personal information of the PAN holder including full name, date of birth, gender, PAN status, and Aadhaar linkage status. The endpoint performs real-time verification of the PAN and returns structured data that can be easily integrated into KYC workflows, customer onboarding processes, and identity verification systems.

Key Benefits

Instant verification of PAN validity with comprehensive holder details

Structured name parsing for better data management and integration

Verification of Aadhaar linkage status for enhanced compliance

Real-time access to official PAN data for reliable identity verification

Use Cases

Financial Services

FinTech

Compliance

Customer onboarding for banking and financial institutions

KYC verification for loan and credit card applications

Identity verification for investment and trading accounts

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")

Example Request

{
    "id_number": "EKRPR1234F"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for the PAN verification 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	Complete name of the PAN holder as registered
data.full_name_split	Array	Name components split into [First Name, Middle Name, Last Name]
data.dob	String	Date of birth in YYYY-MM-DD format
data.gender	String	Gender of the PAN holder (e.g., "M" for Male)
data.status	String	Status of the PAN (e.g., "valid")
data.aadhaar_linked	Boolean	Whether the PAN is linked to Aadhaar (true/false)
data.masked_aadhaar	String	Partially masked Aadhaar number of the PAN holder
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_with_details_v3_BsyouyxbvriTgmFVnRcQ",
        "pan_number": "EKRPR1234F",
        "full_name": "VISHAL SINGH RATHORE",
        "full_name_split": [
            "VISHAL",
            "SINGH",
            "RATHORE"
        ],
        "dob": "2001-07-25",
        "gender": "M",
        "status": "valid",
        "aadhaar_linked": true,
        "masked_aadhaar": "XXXXXXXX5514"
    },
    "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 IP whitelisting for production environments

User Experience Guidelines

Implement proper validation for PAN format before making API calls

Display a user-friendly message when PAN verification fails

Consider caching verified PAN details to improve performance

Implement progressive disclosure of information based on verification status

Code Samples

cURL

Python

Node.js

Related APIs

PAN Basic Verification - Verifies PAN validity without returning detailed information

PAN OCR Verification - Extracts and verifies PAN details from uploaded PAN card images

Aadhaar Verification - Verifies Aadhaar details for comprehensive identity verification

Compliance and Legal Considerations

This API accesses personal information regulated under Indian data protection laws. Ensure you have proper consent from users before verifying their PAN details. The data should be used only for legitimate business purposes such as KYC verification, tax compliance, or regulatory requirements. Store and process the data in compliance with applicable privacy regulations.

{ "data": { "client_id": "pan_with_details_v3_BsyouyxbvriTgmFVnRcQ", "pan_number": "EKRPR1234F", "full_name": "VISHAL SINGH RATHORE", "full_name_split": [ "VISHAL", "SINGH", "RATHORE" ], "dob": "2001-07-25", "gender": "M", "status": "valid", "aadhaar_linked": true, "masked_aadhaar": "XXXXXXXX5514" }, "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 With Details V3

PAN With Details 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 With Details 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