PAN To Father Name

Endpoint Overview

POST /api/v1/pan/pan-to-father-name

Description

This API retrieves the father's name associated with a provided PAN (Permanent Account Number) card in India. It returns comprehensive identity information including the PAN holder's full name, father's name, and name components. This service enables organizations to verify an individual's identity details against official PAN records for KYC (Know Your Customer) processes, identity verification, and fraud prevention.

Key Benefits

Instant verification of PAN holder's father's name without manual document checks

Enhanced KYC compliance with official identity data verification

Reduced identity fraud through reliable government-sourced information

Streamlined customer onboarding with automated identity verification

Use Cases

Financial Services

FinTech

Government & Compliance

Verify customer identity during account opening processes

Validate borrower information during loan application processing

Confirm identity details for insurance policy issuance

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 number for which father's name is to be retrieved. Must be a valid 10-character PAN format.

Example Request

{
    "id_number": "JRXPD1234N"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the verification result data
data.client_id	String	Unique identifier for the verification request
data.pan_number	String	The PAN number that was verified
data.father_name	String	The father's name of the PAN holder
data.full_name	String	The full name of the PAN holder
data.full_name_split	Array	The PAN holder's name split into components [First Name, Middle Name, Last Name]
data.individual_pan	Boolean	Indicates if the PAN belongs to an individual (true) or entity (false)
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 status of the request

Example Successful Response

{
    "data": {
        "client_id": "pan_to_father_name_DdLvDKcbxyHvVLEwBppB",
        "pan_number": "JRXPD1234N",
        "father_name": "DALLU LAL DHEEMAR",
        "full_name": "SHIVRAJ DHEEMAR",
        "full_name_split": [
            "SHIVRAJ",
            "",
            "DHEEMAR"
        ],
        "individual_pan": true
    },
    "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 to ensure data encryption

Implement rate limiting on your end to prevent abuse of the API

User Experience Guidelines

Validate PAN format client-side before making API calls to reduce errors

Implement appropriate loading indicators during API calls

Display clear error messages to users when verification fails

Cache results appropriately to avoid unnecessary repeated calls

Code Samples

cURL

Python

Node.js

Related APIs

PAN Verification API: Verifies if a PAN number is valid and active

PAN OCR API: Extracts information from PAN card images

PAN to Name API: Retrieves the name associated with a PAN number

PAN to DOB API: Retrieves the date of birth associated with a PAN number

Compliance and Legal Considerations

This API accesses personal identity information and is subject to data protection regulations. Ensure you have proper consent from users before verifying their PAN details. Usage of this API must comply with the Information Technology Act, 2000 and the Personal Data Protection Bill of India. Store and process the retrieved information in accordance with applicable privacy laws.

{ "data": { "client_id": "pan_to_father_name_DdLvDKcbxyHvVLEwBppB", "pan_number": "JRXPD1234N", "father_name": "DALLU LAL DHEEMAR", "full_name": "SHIVRAJ DHEEMAR", "full_name_split": [ "SHIVRAJ", "", "DHEEMAR" ], "individual_pan": true }, "status_code": 200, "success": true, "message": null, "message_code": "success" }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

PAN To Father Name

PAN To Father Name#

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 Father Name

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples