PAN With Details V2

Endpoint Overview

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

Description

This API endpoint retrieves comprehensive details associated with a Permanent Account Number (PAN) in India. It validates the PAN number and returns personal information of the PAN holder including full name, date of birth, gender, and current status of the PAN card. This endpoint is particularly useful for KYC (Know Your Customer) processes, identity verification, and regulatory compliance.

Key Benefits

Instant verification of PAN card validity with official records

Structured name parsing for easier data processing and integration

Comprehensive personal details retrieval in a single API call

Real-time status check to ensure the PAN is currently valid

Use Cases

Financial Services

FinTech

Insurance

Customer onboarding for banking and financial institutions

KYC verification for loan and credit card applications

Investment account setup and verification

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	JWT Bearer token for authentication. Format: `Bearer <your_token>`
Content-Type	Yes	Must be set to `application/json`

Request Body

Parameter	Type	Required	Description
id_number	String	Yes	The PAN card number to verify. Must be a valid 10-character alphanumeric PAN format (e.g., ABCDE1234F)

Example Request

{
    "id_number": "EKRPR1234F"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for the PAN verification result data
data.client_id	String	Unique identifier for this verification request
data.pan_number	String	The PAN number that was verified
data.full_name	String	Complete name of the PAN holder as registered
data.full_name_split	Array	Name components broken down 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 (M for Male, F for Female)
data.status	String	Current status of the PAN (valid, invalid, etc.)
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the API call was successful
message	String or null	Additional information about the response
message_code	String	Code indicating the result of the operation

Example Successful Response

{
    "data": {
        "client_id": "pan_with_details_v2_LwpwrtnamlgeaXnauqWB",
        "pan_number": "EKRPR1234F",
        "full_name": "VISHAL SINGH RATHORE",
        "full_name_split": [
            "VISHAL",
            "SINGH",
            "RATHORE"
        ],
        "dob": "2001-07-25",
        "gender": "M",
        "status": "valid"
    },
    "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 and tokens securely, never 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 token 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 (with appropriate security measures)

Code Samples

cURL

Python

Node.js

Related APIs

PAN Basic Verification - Verifies PAN existence without returning detailed information

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

PAN to Aadhaar Linking Status - Checks if a PAN is linked to an Aadhaar number

Compliance and Legal Considerations

This API accesses official PAN data and must be used in compliance with Indian financial regulations. Usage must adhere to data privacy laws including the Personal Data Protection Bill. PAN data should only be collected with explicit user consent and for legitimate business purposes. Storing PAN data requires appropriate security measures as per regulatory guidelines.

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

{ "data": { "client_id": "pan_with_details_v2_LwpwrtnamlgeaXnauqWB", "pan_number": "EKRPR1234F", "full_name": "VISHAL SINGH RATHORE", "full_name_split": [ "VISHAL", "SINGH", "RATHORE" ], "dob": "2001-07-25", "gender": "M", "status": "valid" }, "status_code": 200, "success": true, "message": null, "message_code": "success" }

PAN With Details V2

PAN With Details V2#

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 V2

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples