Mobile-to-Prefill v3

Endpoint Overview

POST /api/v1/pan/mobile-to-prefill-v3

Description

The Mobile-to-Prefill v3 API revolutionizes user onboarding by retrieving comprehensive PAN card details associated with a provided mobile number. This powerful endpoint enables seamless pre-filling of user information in your application, eliminating manual data entry and significantly reducing user friction during KYC processes. The service returns extensive PAN verification data including personal information, historical address records, contact details, and identity document information, allowing businesses to create streamlined, error-free user experiences while maintaining high levels of data accuracy and verification standards.

Key Benefits

Instant Data Population: Automatically populate user forms with verified PAN information, reducing registration time by up to 80%

Enhanced Data Accuracy: Eliminate manual input errors with pre-verified information directly from official PAN records

Comprehensive Profile Building: Access detailed user profiles including address history, contact information, and linked identity documents

Fraud Prevention: Reduce fraudulent registrations through verified mobile-to-PAN linkage validation

Use Cases

Financial Services

E-commerce & Fintech

Real Estate & Services

Digital banking account opening with instant KYC data pre-population

Loan application processing with verified borrower information

Investment platform onboarding with comprehensive user profiles

Credit card applications with pre-filled personal and address details

Insurance policy applications with verified policyholder information

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 JWT token for API authentication
Content-Type	Yes	application/json

Request Body

Parameter	Type	Required	Description
mobile_number	string	Yes	10-digit mobile number associated with PAN records

Example Request

{
    "mobile_number": "7827234123"
}

Process Response

Response Parameters

Parameter	Type	Description
data	object	Complete response data object
data.client_id	string	Unique identifier for the API request session
data.mobile_number	string	Mobile number used for the query
data.prefill_details	object	Comprehensive user profile information
data.prefill_details.client_id	string	Client identifier for prefill report
data.prefill_details.name	string	Full name from records
data.prefill_details.mobile	string	Mobile number from records
data.prefill_details.personal_info	object	Personal demographic information
data.prefill_details.personal_info.full_name	string	Complete name
data.prefill_details.personal_info.dob	string	Date of birth (YYYY-MM-DD)
data.prefill_details.personal_info.gender	string	Gender information
data.prefill_details.personal_info.total_income	string	Income information
data.prefill_details.personal_info.occupation	string/null	Occupation details
data.prefill_details.personal_info.age	string	Age calculation
data.prefill_details.phone_info	array	Historical phone number records
data.prefill_details.address_info	array	Historical address information
data.prefill_details.email_info	array	Email address records
data.prefill_details.identity_info	object	Identity document information
data.pan_details	object	PAN-specific verification data
data.pan_details.pan_status	string	PAN verification status
data.pan_details.pan_details	object	Detailed PAN information
data.pan_details.pan_details.pan_number	string	PAN card number
data.pan_details.pan_details.full_name	string	Name as per PAN
data.pan_details.pan_details.full_name_split	array	Name components
data.pan_details.pan_details.masked_aadhaar	string	Masked Aadhaar number
data.pan_details.pan_details.address	object	Address information
data.pan_details.pan_details.email	string/null	Email address
data.pan_details.pan_details.phone_number	string/null	Phone number
data.pan_details.pan_details.gender	string	Gender code
data.pan_details.pan_details.dob	string	Date of birth
data.pan_details.pan_details.aadhaar_linked	boolean	Aadhaar linkage status
data.pan_details.pan_details.dob_verified	boolean	DOB verification status
data.pan_details.pan_details.category	string	PAN category
data.pan_details.pan_details.status	string	PAN validity status
data.status	string	Overall request status
status_code	integer	HTTP status code
success	boolean	Request success indicator
message	string	Response message
message_code	string	Response message code

Example Successful Response

{
    "data": {
        "client_id": "mobile_to_prefill_v3_ScLOIHCrrmxZAqBQNStN",
        "mobile_number": "7827234123",
        "prefill_details": {
            "client_id": "prefill_report_v2_IJlNQIhKhyCnkzgYkNRH",
            "name": "SATEESH SINGH",
            "mobile": "7827234123",
            "personal_info": {
                "full_name": "SATEESH SINGH ",
                "dob": "1994-11-02",
                "gender": "Male",
                "total_income": "30000",
                "occupation": null,
                "age": "30"
            },
            "phone_info": [
                {
                    "reported_date": "2025-05-15",
                    "type_code": "H",
                    "number": "6219698802"
                },
                {
                    "reported_date": "2025-01-31",
                    "type_code": "H",
                    "number": "7491102312"
                }
            ],
            "address_info": [
                {
                    "address": "MURHARIA KAIMUR BHABU",
                    "state": "BR",
                    "type": "Owns,Permanent",
                    "postal": "921102",
                    "reported_date": "2025-05-15"
                }
            ],
            "email_info": [
                {
                    "reported_date": "2025-01-31",
                    "email_address": "SATEESH123@GMAIL.COM"
                }
            ],
            "identity_info": {
                "pan_number": [
                    {
                        "id_number": "FYWPS1234M"
                    }
                ],
                "passport_number": [],
                "driving_license": [],
                "voter_id": [],
                "aadhaar_number": [
                    {
                        "id_number": "XXXXXXXXXXXX"
                    }
                ],
                "ration_card": [],
                "other_id": [
                    {
                        "id_number": "30065940967604"
                    }
                ]
            }
        },
        "pan_details": {
            "pan_status": "success",
            "pan_details": {
                "pan_number": "FYWPS1234M",
                "full_name": "SATEESH SINGH",
                "full_name_split": [
                    "SATEESH",
                    "SINGH"
                ],
                "masked_aadhaar": "XXXXXXXX2902",
                "address": {
                    "line_1": "",
                    "line_2": "",
                    "street_name": "",
                    "zip": "",
                    "city": "",
                    "state": "",
                    "country": "",
                    "full": ""
                },
                "email": null,
                "phone_number": null,
                "gender": "M",
                "dob": "1994-11-02",
                "input_dob": null,
                "aadhaar_linked": true,
                "dob_verified": false,
                "dob_check": false,
                "category": "person",
                "status": "valid",
                "less_info": false
            }
        },
        "status": "success"
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid Mobile Number

Authentication Error

{
    "status_code": 422,
    "success": false,
    "message": "Verification Failed.",
    "message_code": "verification_failed"
}

The provided PAN number does not match the required format or contains invalid characters.

Integration Best Practices

Security Recommendations

Implement proper input validation for mobile numbers before API calls

Store retrieved PAN information securely with appropriate encryption

Use HTTPS for all API communications to protect sensitive data

Implement proper session management and token refresh mechanisms

Log API usage for audit trails while avoiding logging sensitive data

Validate response data integrity before using in your application

User Experience Guidelines

Provide clear consent mechanisms before collecting mobile numbers

Display loading indicators during API processing time

Pre-populate forms intelligently without overwhelming users

Allow users to review and modify pre-filled information

Implement progressive disclosure for complex address histories

Provide clear error messages when mobile numbers aren't found

Code Samples

cURL

Python

Node.js

Related APIs

PAN Verification API: Direct PAN number validation and verification services

Mobile Number Verification API: Mobile number validation and OTP-based verification

Address Verification API: Comprehensive address validation and standardization services

Identity Document OCR API: Extract information from PAN card images and documents

KYC Complete API: End-to-end KYC verification combining multiple data sources

Compliance and Legal Considerations

This API handles sensitive financial and personal information regulated under Indian financial compliance frameworks including PAN regulations and data protection laws. Ensure you have proper user consent before collecting mobile numbers and PAN information. Implement appropriate data retention policies and use the information only for legitimate KYC and verification purposes. The API is designed for authorized financial services and should not be used for unauthorized data harvesting or privacy violations. Always maintain audit trails of API usage for regulatory compliance.

{ "data": { "client_id": "mobile_to_prefill_v3_ScLOIHCrrmxZAqBQNStN", "mobile_number": "7827234123", "prefill_details": { "client_id": "prefill_report_v2_IJlNQIhKhyCnkzgYkNRH", "name": "SATEESH SINGH", "mobile": "7827234123", "personal_info": { "full_name": "SATEESH SINGH ", "dob": "1994-11-02", "gender": "Male", "total_income": "30000", "occupation": null, "age": "30" }, "phone_info": [ { "reported_date": "2025-05-15", "type_code": "H", "number": "6219698802" }, { "reported_date": "2025-01-31", "type_code": "H", "number": "7491102312" } ], "address_info": [ { "address": "MURHARIA KAIMUR BHABU", "state": "BR", "type": "Owns,Permanent", "postal": "921102", "reported_date": "2025-05-15" } ], "email_info": [ { "reported_date": "2025-01-31", "email_address": "SATEESH123@GMAIL.COM" } ], "identity_info": { "pan_number": [ { "id_number": "FYWPS1234M" } ], "passport_number": [], "driving_license": [], "voter_id": [], "aadhaar_number": [ { "id_number": "XXXXXXXXXXXX" } ], "ration_card": [], "other_id": [ { "id_number": "30065940967604" } ] } }, "pan_details": { "pan_status": "success", "pan_details": { "pan_number": "FYWPS1234M", "full_name": "SATEESH SINGH", "full_name_split": [ "SATEESH", "SINGH" ], "masked_aadhaar": "XXXXXXXX2902", "address": { "line_1": "", "line_2": "", "street_name": "", "zip": "", "city": "", "state": "", "country": "", "full": "" }, "email": null, "phone_number": null, "gender": "M", "dob": "1994-11-02", "input_dob": null, "aadhaar_linked": true, "dob_verified": false, "dob_check": false, "category": "person", "status": "valid", "less_info": false } }, "status": "success" }, "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 ********************

Mobile To Prefill V3

Mobile-to-Prefill 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