Employment Verification
The Employment Verification API is a powerful tool tailored to retrieve recent employment information for individuals using their Mobile Number and PAN (Permanent Account Number) details.
- Data Retrieval: This API fetches crucial employment-related data, including the company name, member ID, date of joining, date of exit, and the associated Universal Account Number (UAN) based on the provided input.
- Input Parameters: Users can input their Mobile Number and PAN details to initiate the employment verification process.
- Efficiency: By providing quick access to recent employment information, the API streamlines the verification process for businesses and organizations.
- Accuracy: The fetched data ensures reliable insights into an individual's employment history, facilitating confident decision-making.
In summary, the Employment Verification API offers a streamlined solution for accessing recent employment data, enhancing efficiency and accuracy in employment verification processes.
Production Environment
UAT/Testing environment
- Mobile Number as Input.
- Mobile Number and PAN as Input.
Parameter | Data Type | Description | Required |
mobileNumber | String | 10-digit Mobile number | M |
panNumber | String | PAN (Permanent Account Number) of the individual. | O |
M - Mandatory; O- Optional
Name | Value | Required | Description |
Content-Type | application/json | M | The type of content that the request body contains. |
Authorization | |||
XXXXXXXXXXXXXXX | M | An authentication token to authorize the request. Reach out to the Signzy support team to get one created. |
M -Mandatory
Parameter | Data Type | Description |
resultCode | Integer | HTTP response code indicating the success or status of the API request. |
employmentSummary | Object | Summary of the individual's EPFO employment status and details. |
employmentSummary.recent_employer_data | Object | Detailed information about the individual's most recent employer. |
employmentSummary.recent_employer_data.member_id | String | Member ID associated with the individual's employment. |
employmentSummary.recent_employer_data.establishment_id | String | Establishment ID associated with the individual's employment. |
employmentSummary.recent_employer_data.date_of_exit | String | Date of exit from employment in format (YYYY-MM-DD). If date of exit is not provided, then the details provided are the person’s current employment. |
employmentSummary.recent_employer_data.date_of_joining | String | Date of joining the provided company in format (YYYY-MM-DD). |
employmentSummary.recent_employer_data.establishment_name | String | Name of the company where the individual is employed. |
employmentSummary.recent_employer_data.employer_confidence_score | Null or Float | Fuzzy matching of “employerName” in input and “establishmentName” to return Float else returns Null (when employer name is not given as input). Enter the full name of the company to avoid less confidence score. |
employmentSummary.recent_employer_data.matching_uan | String | Matching Universal Account Number (UAN) with the input. |
employmentSummary.is_employed | Boolean | True If “employerNameMatch” is true and “employeeNameMatch” is true and employee hasn’t exited from the company (when date_of_exit is empty) th else False. |
employmentSummary.employee_name_match | Boolean | Check if “employeeName” in input and “name” in output matches. Returns True is employeeconfidenceScore is >0.8 else False. |
employmentSummary.employer_name_match | Boolean | Check if “employerName” in input and “establishmentName” in output matches. Returns True is employerconfidenceScore is >0.8 else False. |
employmentSummary.uan_count | Integer | Count of UAN (Universal Account Number) returned as result. (Can be more than 1 when DOB and employee name is used as input). |
employmentSummary.date_of_exit_marked | Boolean | True if the date of exit has been marked. Else False. |
uanDetails | Object | Detailed information about the provided Universal Account Numbers. |
uanDetails.[UAN] | Object | Basic and employment details about the employee associated with the provided UAN. |
uanDetails.[UAN].basic_details | Object | Basic information about the employee. |
uanDetails.[UAN].basic_details.gender | String | Gender of the employee. |
uanDetails.[UAN].basic_details.date_of_birth | String | Date of birth of the employee in format (YYYY-MM-DD). |
uanDetails.[UAN].basic_details.employee_confidence_score | Null or Float | Fuzzy matching of “employeeName” in input and “name” to return Float else returns Null when employee name is not given as input. |
uanDetails.[UAN].basic_details.name | String | Name of the employee. |
uanDetails.[UAN].basic_details.mobile | String | Mobile number of the employee. |
Note: Currently the Mobile number linked with the UAN is not provided by the Source and hence it is given as an empty string. It will only be available once the Source makes it available. | ||
uanDetails.[UAN].basic_details.aadhaar_verification_status | Integer | The Aadhaar verification status of the employee (1 indicates verified). |
uanDetails.[UAN].employment_details | Object | Detailed information about the employee's employment associated with the provided UAN. |
uanDetails.[UAN].employment_details.member_id | String | Member ID associated with the individual's employment. |
uanDetails.[UAN].employment_details.establishment_id | String | Establishment ID associated with the individual's employment. |
uanDetails.[UAN].employment_details.date_of_exit | String | Date of exit from employment in format (YYYY-MM-DD). If date of exit is not provided, then the details provided are the person’s current employment. |
uanDetails.[UAN].employment_details.date_of_joining | String | Date of joining the provided company in format (YYYY-MM-DD). |
uanDetails.[UAN].employment_details.leave_reason | String | Reason for leaving employment, if applicable. |
uanDetails.[UAN].employment_details.establishment_name | String | Name of the establishment where the individual is employed. |
uanDetails.[UAN].employment_details.employer_confidence_score | Null or Float | Fuzzy matching of “employerName” in input and “establishmentName” to return Float else returns Null (when employer name is not given as input). Enter the full name of the company to avoid less confidence score. |
uanNumbers | Array of Strings | List of UANs that are found matching for the input. |
uanDataSource | Array of Objects | Source through which the UANs were obtained. |
uanDataSource.[index] | Object | Universal Account Number (UAN) source details. |
uanDataSource.[index].uan | String | Universal Account Number (UAN). |
uanDataSource.[index].source | String | Source of the UAN (e.g., "mobile", "mobile and PAN"). |
MESSAGE | SIGNZY STATUS CODE | INTERPRETATION |
Loan Application Created Successfully | 200 | Successful txn |
Invalid authentication credentials | 401 | Kindly check authorization |
Invalid input parameter | 400 | Kindly check the params in request body |
Internal server error | 500 | Internal error at Signzy, contact Signzy support |
Error from Upstream | 409 | Upstream Error |
Contact Us for Any Assistance
If you have any questions or need assistance, please reach out to our customer support team. You can contact us via email at. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.
We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!