Mobile To Prefill

Endpoint Overview

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

Description

This API retrieves information associated with a PAN card based on a registered mobile number and name. It provides comprehensive details including personal information, address, contact details, and PAN card status. The API is particularly useful for pre-filling forms and verifying user identity during KYC processes, reducing manual data entry and improving user experience.

Key Benefits

Simplifies user onboarding by auto-filling PAN-related information

Reduces data entry errors by retrieving verified information directly from source

Enhances KYC verification processes with reliable PAN card details

Improves user experience by minimizing manual data entry requirements

Use Cases

Financial Services

Insurance

Digital Onboarding

Pre-filling account opening forms for banks and financial institutions

Streamlining KYC verification for investment platforms

Simplifying loan application processes with verified PAN 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 for authentication (JWT format)
Content-Type	Yes	application/json

Request Body

Parameter	Type	Required	Description
mobile_no	String	Yes	Mobile number associated with the PAN card
name	String	Yes	Name of the PAN card holder
get_address	Boolean	No	For getting address

Example Request

{
    "mobile_no": "9928957216",
    "name": "Vishal"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the retrieved PAN card information
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the request was successful
message	String	Response message
message_code	String	Code representing the response message

Data Object

Parameter	Type	Description
client_id	String	Unique identifier for the client request
mobile_no	String	Mobile number provided in the request
name	String	Name provided in the request
pan_number	String	PAN card number of the individual
pan_details	Object	Comprehensive details associated with the PAN card

pan_details Object

Parameter	Type	Description
pan_number	String	PAN Card number
full_name	String	Full name of PAN holder
full_name_split	Array	Full name split into [First Name, Middle Name, Last Name]
masked_aadhaar	String	Masked Aadhaar number of PAN holder
address	Object	Full address details of PAN holder
email	String	PAN holder's email address
phone_number	String	Mobile number of PAN holder
gender	String	Gender of PAN holder (M/F)
dob	String	PAN holder's birth date in "YYYY-MM-DD" format
input_dob	String	PAN holder's input birth date in "YYYY-MM-DD" format (if provided)
aadhaar_linked	Boolean	Indicates if PAN is linked with Aadhaar
dob_verified	Boolean	Indicates if date of birth is verified
dob_check	Boolean	Indicates if date of birth check passed
category	String	PAN category (e.g., "person", "company")
less_info	Boolean	Indicates if limited information is available

address Object

Parameter	Type	Description
line_1	String	House number/building details
line_2	String	Colony/Society name
street_name	String	Street name
zip	String	Postal/PIN code
city	String	City name
state	String	State name
country	String	Country name
full	String	Complete formatted address

Example Successful Response

{
    "data": {
        "client_id": "mobile_to_prefill_IIMmfvqjvmpbPEolXWuk",
        "mobile_no": "8079012345",
        "name": "vishal",
        "pan_number": "EKRPR1234F",
        "pan_details": {
            "pan_number": "EKRPR1234F",
            "full_name": "VISHAL SINGH RATHORE",
            "full_name_split": [
                "VISHAL",
                "SINGH",
                "RATHORE"
            ],
            "masked_aadhaar": "XXXXXXXX1234",
            "address": {
                "line_1": "A 4 ",
                "line_2": "Jagatpura",
                "street_name": "Jagatpura S.O",
                "zip": "123456",
                "city": "Jaipur",
                "state": "RAJASTHAN",
                "country": "INDIA",
                "full": "A 4  Jagatpura  S.O 123456 Jaipur RAJASTHAN INDIA"
            },
            "email": "vishalrathore0000@gmail.com",
            "phone_number": "8079012345",
            "gender": "M",
            "dob": "2001-07-25",
            "input_dob": null,
            "aadhaar_linked": true,
            "dob_verified": false,
            "dob_check": false,
            "category": "person",
            "less_info": false
        }
    },
    "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

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 end to prevent abuse

Log API requests and responses for audit purposes, but mask sensitive data

User Experience Guidelines

Implement proper validation before making API calls to reduce errors

Display a loading indicator during API calls to improve user experience

Provide clear error messages to users when API calls fail

Allow users to verify and edit pre-filled information before submission

Implement proper fallback mechanisms when the API is unavailable

Code Samples

cURL

Python

Node.js

Related APIs

PAN Card Verification API: Verifies PAN card details against government records

Aadhaar Verification API: Verifies Aadhaar card details

Address Verification API: Verifies address details against official records

Document OCR API: Extracts information from uploaded PAN card images

Compliance and Legal Considerations

This API handles personal and financial information that is subject to data protection regulations. Ensure you have proper consent from users before accessing their PAN details. The data should be stored securely and used only for the purpose disclosed to the user. Compliance with KYC norms, Information Technology Act, and other relevant financial regulations is mandatory when using this API for identity verification purposes.

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-prefill' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "mobile_no": "9928957216", "name": "Vishal" }'

{ "data": { "client_id": "mobile_to_prefill_IIMmfvqjvmpbPEolXWuk", "mobile_no": "8079012345", "name": "vishal", "pan_number": "EKRPR1234F", "pan_details": { "pan_number": "EKRPR1234F", "full_name": "VISHAL SINGH RATHORE", "full_name_split": [ "VISHAL", "SINGH", "RATHORE" ], "masked_aadhaar": "XXXXXXXX1234", "address": { "line_1": "A 4 ", "line_2": "Jagatpura", "street_name": "Jagatpura S.O", "zip": "123456", "city": "Jaipur", "state": "RAJASTHAN", "country": "INDIA", "full": "A 4 Jagatpura S.O 123456 Jaipur RAJASTHAN INDIA" }, "email": "vishalrathore0000@gmail.com", "phone_number": "8079012345", "gender": "M", "dob": "2001-07-25", "input_dob": null, "aadhaar_linked": true, "dob_verified": false, "dob_check": false, "category": "person", "less_info": false } }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Mobile To Prefill

Mobile To Prefill#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Data Object#

pan_details Object#

address Object#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

Mobile To Prefill

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Data Object

pan_details Object

address Object

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples