Current Employment PAN Mobile

Endpoint Overview

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

Description

This API endpoint retrieves an employee's EPFO (Employees' Provident Fund Organisation) details by using their mobile number, PAN (Permanent Account Number), or UAN (Universal Account Number). The endpoint provides comprehensive employment information including current employer details, employment history, and EPFO establishment information.

Key Benefits

Verify employment status and history without requiring physical documents

Access official EPFO records for employment verification

Validate employee identity across multiple identifiers (PAN, mobile, UAN)

Retrieve detailed establishment information for background verification

Use Cases

Financial Services

HR & Recruitment

Insurance

Verify employment details during loan application processing

Confirm employment stability for credit risk assessment

Validate income sources for financial product eligibility

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)
Content-Type	Yes	application/json

Request Body

Parameter	Type	Required	Description
mobile_number	String	Conditional*	Mobile number of the employee
pan_number	String	Conditional*	PAN number of the employee
uan_number	String	Conditional*	UAN number of the employee
employer_name	String	No	Name of the employer for improved matching
employee_name	String	No	Name of the employee for improved matching

*At least one of mobile_number, pan_number, or uan_number is required.

Example Request

{
    "pan_number": "EKRPR1234F"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains all the employment and EPFO details
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

Data Object

Parameter	Type	Description
client_id	String	Unique identifier for the request
uan	String	Universal Account Number of the employee
employment_details	Object	Current employment information
month_history	Array	Monthly employment status history
epfo_details	Object	Detailed EPFO establishment information

Employment Details Object

Parameter	Type	Description
member_id	String	EPFO member ID of the employee
doe_epf	String	Date of exit from EPF (null if currently employed)
leave_reason	String	Reason for leaving (null if currently employed)
doj_epf	String	Date of joining EPF
name	String	Employee's name as per EPFO records
company_name	String	Employer's company name

Month History Object (Array Items)

Parameter	Type	Description
month_year	String	Month and year of the employment record
status	Boolean	Employment status for that month

EPFO Details Object

Parameter	Type	Description
employee_name_matching_score	String	Score indicating name match accuracy
employer_name_matching_score	String	Score indicating employer name match accuracy
establishment_id	String	EPFO establishment ID
establishment_name	String	Name of the establishment
establishment_info	Object	Detailed establishment information

Establishment Info Object

Parameter	Type	Description
address	String	Physical address of the establishment
city	String	City where establishment is located
establishment_name	String	Name of the establishment
district	String	District where establishment is located
state	String	State where establishment is located
region	String	Region code of the establishment
establishment_id	String	EPFO establishment ID
less_info	Boolean	Indicates if limited information is available

Example Successful Response

{
    "data": {
        "client_id": "current_employment_pan_mobile_iHKSrdxkCldxiLerXdrL",
        "uan": "100343838122",
        "employment_details": {
            "member_id": "MHBAN01234450000020111",
            "doe_epf": null,
            "leave_reason": null,
            "doj_epf": null,
            "name": "SEKH ALLIM",
            "company_name": "INDIAFIRST LIFE INSURANCE COMPANY LIMITED"
        },
        "month_history": [],
        "epfo_details": {
            "employee_name_matching_score": "0",
            "employer_name_matching_score": "0",
            "establishment_id": "MHBAN0123445000",
            "establishment_name": "INDIAFIRST LIFE INSURANCE COMPANY LIMITED",
            "establishment_info": {
                "address": "12,13TH FLOOR NORTH C WING\r\nT 4 NESCO IT PARK WESTERN EXP\r\nHIGHWAY GOREGAON EAST MAHARASHTRA",
                "city": "GOREGAON EAST",
                "establishment_name": "INDIAFIRST LIFE INSURANCE COMPANY LIMITED",
                "district": "GOREGAON EAST",
                "state": "MAHARASHTRA",
                "region": "MH",
                "establishment_id": "MHBAN0123445000",
                "less_info": false
            }
        }
    },
    "status_code": 200,
    "success": true,
    "message": null,
    "message_code": "success"
}

Possible Error Responses

Invalid Input

Not Found

Authentication Error

{
    "data": null,
    "status_code": 400,
    "success": false,
    "message": "At least one of PAN, mobile number, or UAN is required",
    "message_code": "invalid_input"
}

This error occurs when none of the required identifiers (PAN, mobile, UAN) are provided.

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 to ensure data encryption

Implement rate limiting to prevent abuse of the API

User Experience Guidelines

Provide clear feedback to users when verification is in progress

Implement fallback options if one identifier (PAN/mobile/UAN) doesn't yield results

Cache results appropriately to improve response times for repeated queries

Implement proper validation for input parameters before making API calls

Code Samples

cURL

Python

Node.js

Related APIs

EPFO UAN Verification API - Verifies UAN details against EPFO records

Employment History API - Retrieves detailed employment history from EPFO

PAN Verification API - Verifies PAN card details against government records

Mobile Number Verification API - Verifies mobile number ownership and details

Compliance and Legal Considerations

This API accesses EPFO data which is governed by Indian data protection regulations. Ensure you have proper consent from individuals before retrieving their employment information. The data should be used only for legitimate business purposes as permitted by applicable laws and regulations. Storing this data may be subject to data retention policies under various compliance frameworks.

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/employment/current-employment-pan-mobile' \ --header 'Content-Type: application/json' \ --data-raw '{ "pan_number": "EKRPR1234F" }'

{ "data": { "client_id": "current_employment_pan_mobile_iHKSrdxkCldxiLerXdrL", "uan": "100343838122", "employment_details": { "member_id": "MHBAN01234450000020111", "doe_epf": null, "leave_reason": null, "doj_epf": null, "name": "SEKH ALLIM", "company_name": "INDIAFIRST LIFE INSURANCE COMPANY LIMITED" }, "month_history": [], "epfo_details": { "employee_name_matching_score": "0", "employer_name_matching_score": "0", "establishment_id": "MHBAN0123445000", "establishment_name": "INDIAFIRST LIFE INSURANCE COMPANY LIMITED", "establishment_info": { "address": "12,13TH FLOOR NORTH C WING\r\nT 4 NESCO IT PARK WESTERN EXP\r\nHIGHWAY GOREGAON EAST MAHARASHTRA", "city": "GOREGAON EAST", "establishment_name": "INDIAFIRST LIFE INSURANCE COMPANY LIMITED", "district": "GOREGAON EAST", "state": "MAHARASHTRA", "region": "MH", "establishment_id": "MHBAN0123445000", "less_info": false } } }, "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 ********************

Current Employment PAN Mobile

Current Employment PAN Mobile#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Data Object#

Employment Details Object#

Month History Object (Array Items)#

EPFO Details Object#

Establishment Info Object#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

Current Employment PAN Mobile

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Data Object

Employment Details Object

Month History Object (Array Items)

EPFO Details Object

Establishment Info Object

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples