Mobile to PAN Advanced Verification

Endpoint Overview

POST /api/v1/pan/mobile-to-pan-adv

Description

The Mobile to PAN Advanced API enables instant verification and retrieval of PAN (Permanent Account Number) details using a mobile number. This endpoint provides enhanced data accuracy and comprehensive verification capabilities, making it ideal for KYC processes, user onboarding, and identity verification workflows.

The API performs real-time lookups against authoritative databases to match mobile numbers with corresponding PAN information, including the cardholder's name and verified contact details. This advanced version offers improved data quality and faster response times compared to standard mobile-to-PAN services.

Key Benefits

Instant Verification: Real-time PAN details retrieval using mobile number

Enhanced Accuracy: Advanced matching algorithms for reliable data

Seamless Integration: RESTful API with simple JSON request/response format

Dual Environment Support: Separate sandbox and production environments for testing and deployment

Use Cases

Financial Services

E-commerce & Retail

Government & Public

Customer Onboarding: Streamline KYC processes by instantly verifying PAN details during account opening

Loan Applications: Quick identity verification for lending platforms and NBFC services

Digital Payments: Verify customer identity for wallet services and payment gateways

Investment Platforms: Comply with regulatory requirements for trading and investment 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.app

Production: https://kyc-api.surepass.app

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token for API authentication (JWT format)
Content-Type	Yes	Must be set to `application/json`

Request Body

Parameter	Type	Required	Description
mobile_number	string	Yes	10-digit Indian mobile number without country code or special characters
name	string	No	Full name of the PAN holder as per official records

Example Request

{
    "mobile_number": "9876543210",
    "name": "Arvind Kumar Singh"
}

Process Response

Response Parameters

Parameter	Type	Description
data	object	Container object for verification results
data.client_id	string	Unique identifier for this verification request
data.name	string	Full name of the PAN holder as per official records
data.mobile_number	string	Verified mobile number associated with the PAN
data.pan_number	string	10-character PAN number in standard format
status_code	integer	HTTP status code indicating request outcome
success	boolean	Indicates whether the verification was successful
message	string	Human-readable response message
message_code	string	Machine-readable response code for programmatic handling

Example Successful Response

{
    "data": {
        "client_id": "mobile_to_pan_adv_avoglYdKwzAkalClhsnr",
        "name": "Arvind Kumar Singh",
        "mobile_number": "9876543210",
        "pan_number": "ABCDE1234F"
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Authentication Error

{
    "data": null,
    "status_code": 401,
    "success": false,
    "message": "Invalid or expired authentication token",
    "message_code": "authentication_failed"
}

Returned when the JWT token is invalid, expired, or missing from the request.

Integration Best Practices

Security Recommendations

Token Management: Store JWT tokens securely and implement automatic refresh mechanisms

Data Encryption: Use HTTPS for all API communications and encrypt sensitive data in transit

Access Control: Implement proper role-based access controls for API usage

Rate Limiting: Implement client-side rate limiting to prevent API quota exhaustion

User Experience Guidelines

Input Validation: Validate mobile number format on the client side before API calls

Loading States: Show appropriate loading indicators during API requests

Error Handling: Provide clear, user-friendly error messages for failed verifications

Data Privacy: Clearly communicate data usage policies to end users

Code Samples

cURL

Python

Node.js

Related APIs

PAN Verification: Direct PAN number validation and details retrieval

Mobile Number Verification: OTP-based mobile number validation service

Aadhaar Verification: Identity verification using Aadhaar number

Bank Account Verification: Account holder name and status verification

Compliance and Legal Considerations

This API processes sensitive personal information including PAN and mobile numbers. Ensure compliance with applicable data protection regulations such as the Digital Personal Data Protection Act, 2023. Obtain proper user consent before processing personal data and implement appropriate data retention and deletion policies. Use this service only for legitimate business purposes and authorized identity verification requirements.

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/mobile-to-pan-adv' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "mobile_number": "9876543210", "name": "Arvind Kumar Singh" }'

{ "data": { "client_id": "mobile_to_pan_adv_avoglYdKwzAkalClhsnr", "name": "Arvind Kumar Singh", "mobile_number": "9876543210", "pan_number": "ABCDE1234F" }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Mobile To PAN Advance

Mobile to PAN Advanced Verification#

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