Past Employment History

Introduction:

This API is responsible for fetching the EPFO's Past Employment History based on the Universal Account Number (UAN). This paints a vivid and detailed picture of an individual's employment history, offering valuable insights into their professional journey.

cURL

curl --location 'https://api.signzy.app/api/v3/underwriting/fetch-employment-history' \
--header 'Authorization: <auth-token>' \
--header 'Content-Type: application/json' \
--data '{
    "pan": "",
    "mobile": "",
    "uan": "",
    "dob": "",
    "employeeName": ""
}'

Request Headers:

Key	Value
Authorization	shared by Signzy
Content-type	application/json

Request Body

{
    "pan": "",
    "mobile": "",
    "uan": "",
    "dob": "",
    "employeeName": ""
}

PARAMETERS	DESCRIPTION	TYPE	VALUE (COMPULSORY OR OPTIONAL)
uan	UAN stands for Universal Account Number. It is a unique 12-digit identification number assigned to employees contributing to the Employees' Provident Fund (EPF) in India.	String	Conditional Mandatory
pan	Pan number of the individual	String	Conditional Mandatory
mobile	Mobile number of the individual	String	Conditional Mandatory
dob	Date of Birth of the individual	String	Conditional Mandatory
employeeName	Name of the employee	String	Conditional Mandatory

Search Methods:

PAN-based lookup

Lookup is performed using PAN.

Mobile-based lookup

Lookup is performed using mobile number.

Direct UAN lookup

Provided UAN is directly used.

PAN with Mobile fallback

PAN lookup is attempted first.

If UAN is not found, lookup proceeds with Mobile.

Combined lookup using PAN, Mobile, DOB & Employee Name Lookup priority:

Mobile

DOB + Employee Name

Note: If UAN, PAN, mobile number, and date of birth are all provided in the request, the search will be performed using the UAN only. PAN, mobile number, and date of birth will be ignored.

Response Data

{
    "error": {
        "reason": "No record(s) found",
        "status": 404,
        "message": "ERROR",
        "type": "Not Found",
        "statusCode": 404,
        "name": "error"
    }
}

PARAMETERS	DESCRIPTION	TYPE
result	This parameter contains the actual output i.e. a list of objects consisting of sub-fields such as 'dateOfExit', 'dateOfJoining', 'establishmentName', 'memberId', 'fatherOrHusbandName', 'name', 'uan'	List[Object]
result[].uan	Stands for Universal Account Number, a unique 12-digit identification number assigned to employees contributing to the Employees' Provident Fund (EPF) in India.	String
result[].memberId	Represents a unique identifier assigned to the member in the employment system. It is often used for tracking and referencing the individual's record.	String
result[].name	Specifies the name of the individual.	String
result[].fatherOrHusbandName	Contains the name of the individual's father or husband.	String
result[].establishmentId	A unique identifier for the establishment where the employee worked.	String
result[].establishmentName	This represents the name of the establishment	String
result[].dateOfJoining	Indicates the date when the individual joined the employment. In the example, the date format is "DD-MMM-YYYY"(e.g., 31-OCT-2018).	String
result[].dateOfExit	Indicates the date when the individual exited or left the employment. In the example, the date format is "DD-MMM-YYYY"(e.g., 31-OCT-2018).	String
result[].tenureOfEmployment	The duration of the employee's tenure at the establishment, typically measured in months.	Number
additionalDetails	An object containing the additional details of the employment history	Object
additionalDetails.limitedOutput	A boolean indicating whether the output is limited (true) or complete (false).	Boolean
additionalDetails.uanDataSource[].uan	The Universal Account Number used to retrieve the information.	String
additionalDetails.uanDataSource[].source	The source from which the UAN information was derived (e.g., PAN, Aadhaar).	String
additionalDetails.recentEmployerData.memberId	The membership ID of the employee's most recent employer.	String
additionalDetails.recentEmployerData.establishmentId	The unique identifier of the most recent establishment.	String
additionalDetails.recentEmployerData.dateOfExit	The exit date from the most recent establishment.	String
additionalDetails.recentEmployerData.dateOfJoining	The joining date for the most recent establishment.	String
additionalDetails.recentEmployerData.establishmentName	The name of the most recent organization where the employee worked.	String
additionalDetails.recentEmployerData.employerConfidenceScore	A score indicating the confidence in the employer's information (may be null).	String
additionalDetails.uanDetails[]	Contains detailed UAN information, including basic and employment details.	Array

NOTE: The above fields are Compulsory during 200 OK Response.

Sample Status Codes And Messages

{
    "error": {
        "reason": "Unable to fetch data from upstream",
        "status": 409,
        "message": "ERROR",
        "type": "Conflict",
        "statusCode": 409,
        "name": "error"
    }
}

1. Something went wrong. please try again.
2. Unable to fetch data from upstream
2. Invalid request. Please check Token and/or Data.