Pan To Current Employment

Endpoint Overview

POST /api/v1/employment/pan-to-current-employment

Description

This API retrieves the current employment details for an individual using their PAN (Permanent Account Number). It provides comprehensive information about the individual's employment status, including EPFO (Employees' Provident Fund Organisation) details, personal information, and banking details associated with their employment record.

Key Benefits

Instant verification of an individual's current employment status

Access to comprehensive EPFO-linked employment data

Simplified KYC process for employment verification

Reduced manual verification efforts and paperwork

Use Cases

Financial Services

HR & Recruitment

Insurance

Verify employment status during loan application processing

Validate income sources for credit assessment

Confirm employment history for mortgage applications

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
pan_number	String	Yes	PAN Number of the individual whose employment details are being requested

Example Request

{
    "pan_number": "EKRPR1234F"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the response data
data.client_id	String	Unique Client ID for the request
data.pan_number	String	PAN number of the individual
data.uan	String	Universal Account Number (UAN) of the individual
data.employment_details	Object	Contains detailed employment information
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the request was successful
message	String	Additional message (null if successful)
message_code	String	Code indicating the status of the request

Employment Details Object

Parameter	Type	Description
client_id	String	Unique client ID for the employment details
uan	String	Universal Account Number (UAN) of the individual
is_elig	String	Eligibility status of the individual (Y/N)
proc_status	String	Process status indicator
doe_eps	String	Date of exit from EPS in YYYY-MM-DD format
aadhaar_number	String	Masked Aadhaar number of the individual
mobile_number	String	Mobile number of the individual
member_id	String	Member ID associated with EPFO
doe_epf	String	Date of exit from EPF in YYYY-MM-DD format
status	String	Verification status
email_id	String	Email address of the individual
dob	String	Date of birth of the individual in YYYY-MM-DD format
doj_eps	String	Date of joining EPS in YYYY-MM-DD format
pan_number	String	PAN number of the individual
gender	String	Gender of the individual (M/F)
leave_reason	String	Reason for leaving employment
doj_epf	String	Date of joining EPF in YYYY-MM-DD format
bank_ifsc	String	IFSC code of the individual's bank
back_account_no	String	Bank account number of the individual
bank_details	String	Details of the bank including name and branch
name	String	Name of the individual
father_or_husband_name	String	Name of the individual's father or husband
father_or_husband	String	Relationship indicator (F for Father, H for Husband)
leave_reason_code	String	Code corresponding to the leave reason

Example Successful Response

{
    "data": {
        "client_id": "pan_to_current_employment_uIDalttFsmBdsLRizYQE",
        "pan_number": "EKRPR1234F",
        "uan": "101669821234",
        "employment_details": {
            "client_id": "epfo_details_advanced_RHNaLwspBeaJwXHJwikV",
            "uan": "101669821234",
            "is_elig": "Y",
            "proc_status": "0",
            "doe_eps": "2021-05-17",
            "aadhaar_number": "XXXXXXXX5514",
            "mobile_number": "8079012345",
            "member_id": "KDMAL00478080000312345",
            "doe_epf": "2021-05-17",
            "status": "V",
            "email_id": "vishalrathore@gmail.com",
            "dob": "2001-07-25",
            "doj_eps": "2021-03-15",
            "pan_number": "EKRPR1234F",
            "gender": "M",
            "leave_reason": "CESSATION (SHORT SERVICE) - Any other reason",
            "doj_epf": "2021-05-17",
            "bank_ifsc": "UTIB0002878",
            "back_account_no": "920010012345678",
            "bank_details": "AXIS BANK,JAGATPURA JAIPUR",
            "name": "VISHAL RATHORE",
            "father_or_husband_name": "RAJENDRA SINGH",
            "father_or_husband": "F",
            "leave_reason_code": "5"
        }
    },
    "status_code": 200,
    "success": true,
    "message": null,
    "message_code": "success"
}

Possible Error Responses

Invalid PAN

PAN Not Found

Authentication Error

{
    "data": null,
    "status_code": 400,
    "success": false,
    "message": "Invalid PAN number format",
    "message_code": "invalid_pan_format"
}

The provided PAN number does not match the required format.

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

Implement rate limiting on your end to prevent abuse

Regularly rotate authentication credentials

User Experience Guidelines

Implement proper loading states while waiting for API response

Display clear error messages to users when verification fails

Cache results when appropriate to improve response times

Provide clear instructions for users when manual verification is needed

Format dates and other structured data in a user-friendly manner

Code Samples

cURL

Python

Node.js

Related APIs

EPFO UAN Verification API: Verifies UAN details directly with EPFO

PAN Verification API: Validates PAN details with government records

Employment History API: Retrieves historical employment records

Bank Account Verification API: Verifies bank account details

Compliance and Legal Considerations

This API accesses personal and employment data that is subject to privacy regulations. Ensure you have proper consent from individuals before retrieving their employment information. Usage of this API must comply with applicable data protection laws including but not limited to the Information Technology Act and potential Personal Data Protection regulations in India. The data should only be used for legitimate business purposes with proper authorization.

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/employment/pan-to-current-employment' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "pan_number": "EKRPR1234F" }'

{ "data": { "client_id": "pan_to_current_employment_uIDalttFsmBdsLRizYQE", "pan_number": "EKRPR1234F", "uan": "101669821234", "employment_details": { "client_id": "epfo_details_advanced_RHNaLwspBeaJwXHJwikV", "uan": "101669821234", "is_elig": "Y", "proc_status": "0", "doe_eps": "2021-05-17", "aadhaar_number": "XXXXXXXX5514", "mobile_number": "8079012345", "member_id": "KDMAL00478080000312345", "doe_epf": "2021-05-17", "status": "V", "email_id": "vishalrathore@gmail.com", "dob": "2001-07-25", "doj_eps": "2021-03-15", "pan_number": "EKRPR1234F", "gender": "M", "leave_reason": "CESSATION (SHORT SERVICE) - Any other reason", "doj_epf": "2021-05-17", "bank_ifsc": "UTIB0002878", "back_account_no": "920010012345678", "bank_details": "AXIS BANK,JAGATPURA JAIPUR", "name": "VISHAL RATHORE", "father_or_husband_name": "RAJENDRA SINGH", "father_or_husband": "F", "leave_reason_code": "5" } }, "status_code": 200, "success": true, "message": null, "message_code": "success" }

Pan To Current Employment

Pan To Current Employment#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Employment Details Object#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

Pan To Current Employment

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Employment Details Object

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples