Basic Employment Verification V2
The Basic Employment Verification API represents a significant advancement in simplifying the process of verifying an individual's employment status within a company. By harnessing EPFO UAN data, this API offers enhanced coverage and accuracy compared to its predecessor, the Basic Employment Verification V1 API.
- Utilization of EPFO UAN Data: Leveraging the UAN number, this API retrieves recent employment details of individuals and cross-references them with employer data for verification purposes.
- Improved Accuracy with UAN Lookup: The API introduces support for UAN Lookup based on the individual's Name and Date of Birth, significantly enhancing the accuracy and reliability of its results.
- Comprehensive Functionality: This API provides a comprehensive solution for employment verification, encompassing all functionalities for employment verification.
In summary, the Basic Employment Verification API serves as a valuable resource, simplifying the employment verification process for businesses. With improved coverage, accuracy, and functionality, it offers businesses a reliable solution for verifying employment status.
Key | Value |
Authorization | access token (returned as id field of login request) |
Content-type | application/json |
Parameter | Description | Validation Checks | Type | Required |
mobileNumber | Mobile number of the employee | 10 digits (only numeric) | String | Conditional Mandatory |
panNumber | PAN number of the employee | Regex for PAN number | String | Conditional Mandatory |
uanNumber | UAN (Universal Account Number) of the employee | 12 digits (only numeric) | String | Conditional Mandatory |
dateOfBirth | Date of birth of the employee | Format: DD-MM-YYYY | String | Conditional Mandatory |
employeeName | Name of the employeRequest Data e | | String | Conditional Mandatory |
employerName | Name of the employer | | String | Optional |
nameMatchMethod | Method used to match employee and employer names | Enum: fuzzy or exact (Default: fuzzy) | String | Optional |
Key | Type | Value |
httpResponseCode | Integer | 200 |
clientRefNum | String | "7c9112cd-e3ea-4e1b-965a-be1a1bc8d3dc" |
requestId | String | "dg3009ce" |
resultCode | Integer | 101 |
uan | Array | ["100974202120"] |
recentEmployerData.memberId | String | "PUPUN17530220000010149" |
recentEmployerData.establishmentId | String | "PUPUN1753022000" |
recentEmployerData.dateOfExit | String | "" |
recentEmployerData.dateOfJoining | String | "2020-10-09" |
recentEmployerData.establishmentName | String | "Signzy Technologies Private Limited" |
recentEmployerData.employerConfidenceScore | null | null |
recentEmployerData.matchingUan | String | "100974202120" |
isEmployed | Boolean | true |
employeeNameMatch | null | null |
employerNameMatch | null | null |
uanCount | Integer | 1 |
dateOfExitMarked | Boolean | false |
uanDetails.100974202120.basicDetails.gender | String | "MALE" |
uanDetails.100974202120.basicDetails.dateOfBirth | String | "1992-07-10" |
uanDetails.100974202120.basicDetails.employeeConfidenceScore | null | null |
uanDetails.100974202120.basicDetails.name | String | "Kasukurti Ramakrishna" |
uanDetails.100974202120.basicDetails.mobile | String | "" |
uanDetails.100974202120.basicDetails.aadhaarVerificationStatus | Integer | 1 |
uanDetails.100974202120.employmentDetails.memberId | String | "PUPUN17530220000010149" |
uanDetails.100974202120.employmentDetails.establishmentId | String | "PUPUN1753022000" |
uanDetails.100974202120.employmentDetails.dateOfExit | String | "" |
uanDetails.100974202120.employmentDetails.dateOfJoining | String | "2020-10-09" |
uanDetails.100974202120.employmentDetails.leaveReason | String | "" |
uanDetails.100974202120.employmentDetails.establishmentName | String | "Signzy Technologies Private Limited" |
uanDetails.100974202120.employmentDetails.employerConfidenceScore | null | null |
uanSource | Array | [{"uan": "100974202120", "source": "mobile"}] |
nameDobFilteringScore | null | null |
inputData.mobile | String | "8008331337" |
inputData.pan | String | "DFYPK1218G" |
inputData.uan | String | "" |
inputData.dob | String | "" |
inputData.employee_name | String | "" |
inputData.employer_name | String | "" |
inputData.name_match_method | String | "" |
Error Code | Description |
200 | Success - The request was processed successfully. |
400 | Bad Request - The request was malformed or invalid. |
404 | Not Found - The requested resource was not found. |
409 | Conflict - The request conflicts with the server state. |
500 | Internal Server Error - An unexpected error occurred. |