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:
- PAN
- 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.