PAN To Aadhaar

Endpoint Overview

POST /api/v1/pan/pan-to-aadhaar

Description

This API enables you to retrieve the masked Aadhaar number associated with a provided PAN (Permanent Account Number). It serves as a verification tool to confirm the link between a user's PAN and Aadhaar, returning only a partially masked Aadhaar number for privacy and security reasons. This service helps businesses validate identity information while maintaining compliance with data protection regulations.

Key Benefits

Instant verification of PAN-Aadhaar linkage without manual intervention

Enhanced KYC processes with reliable government database checks

Reduced identity fraud through cross-verification of identity documents

Compliance with regulatory requirements for identity verification

Use Cases

Financial Services

Fintech

Government Services

Account opening verification for banks and NBFCs

Loan application processing with enhanced KYC

Insurance policy issuance with verified identity details

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 with JWT token
Content-Type	Yes	Application/json

Request Body

Parameter	Type	Required	Description
pan_number	String	Yes	Valid 10-character PAN number of the individual

Example Request

{
    "pan_number": "FPVPR1234Q"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for the response data
data.client_id	String	Unique identifier for the API request
data.pan_number	String	The PAN number provided in the request
data.aadhaar_number	String	Masked Aadhaar number with only last 4 digits visible
status_code	Integer	HTTP status code indicating the result of the request
success	Boolean	Indicates whether the API call was successful
message	String	Human-readable description of the response
message_code	String	Machine-readable code for the response status

Example Successful Response

{
    "data": {
        "client_id": "pan_to_aadhaar_hlrvaccjinoAfNyjGqYg",
        "pan_number": "FPVPR1234Q",
        "aadhaar_number": "XXXXXXXX5839"
    },
    "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 rate limiting on your end to prevent abuse of the API

User Experience Guidelines

Clearly explain to users why PAN-Aadhaar verification is required

Implement proper validation of PAN format before making API calls

Display appropriate error messages that guide users to resolution

Consider implementing a retry mechanism for temporary failures

Code Samples

cURL

Python

Node.js

Related APIs

PAN Verification API: Validates PAN details against government records

Aadhaar Verification API: Verifies Aadhaar details with OTP authentication

Document OCR API: Extracts information from PAN and Aadhaar cards automatically

Compliance and Legal Considerations

This API adheres to the guidelines set by UIDAI and Income Tax Department of India for handling PAN and Aadhaar data. The Aadhaar number is always returned in a masked format to comply with privacy regulations. Ensure you have appropriate consent from users before verifying their PAN-Aadhaar linkage and maintain proper records of such consent as required by applicable laws.

{ "data": { "client_id": "pan_to_aadhaar_hlrvaccjinoAfNyjGqYg", "pan_number": "FPVPR1234Q", "aadhaar_number": "XXXXXXXX5839" }, "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 To Aadhaar

PAN To Aadhaar#

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 To Aadhaar

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples