Current Employer Advanced

Introduction

The Current Employer Advanced API represents a significant advancement in simplifying the process of verifying an individual's employment status within a company. By harnessing EPFO UAN data and Provident Fund filings of individuals, this API offers enhanced coverage.

Key Features

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.

Merged results with Provident Fund: Leveraging the PF filings done by companies for their employees, this API provides comprehensive output from two different sources from EPFO.

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.

Conclusion

In summary, the Current Employer Advanced 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.

Sample Curl:

curl --location 'https://api.signzy.app/api/v3/employment-verification/current-employer-advanced' \
--header 'Authorization: <auth-token>' \
--header 'Content-Type: application/json' \
--data '{
	"mobile": "1234567890",
	"panNumber": "ABCDE1234F"
}'

Input Parameters:

Parameter	Type	Description	Mandatory/Optional
mobile	String	10 digit mobile number	Mandatory
panNumber	String	PAN number of the Individual	Optional

Sample Output:

{
	"resultCode": 200,
	"employmentSummary": {
		"recent_employer_data": {
			"member_id": "DUMMYMEMBERID1234567890",
			"establishment_id": "DUMMYESTID1234",
			"date_of_exit": "",
			"date_of_joining": "2022-09-12",
			"establishment_name": "Dummy Company Name",
			"employer_confidence_score": null,
			"matching_uan": "DUMMYUAN123456",
			"current_tenure": 23
		},
		"matching_uan": "DUMMYUAN123456",
		"is_employed": true,
		"employee_name_match": null,
		"employer_name_match": null,
		"uan_count": 1,
		"date_of_exit_marked": false
	},
	"uanDetails": {
		"DUMMYUAN123456": {
			"basic_details": {
				"gender": "MALE",
				"date_of_birth": "2000-05-15",
				"employee_confidence_score": null,
				"name": "Dummy Name",
				"mobile": "1234567890",
				"aadhaar_verification_status": -1
			},
			"employment_details": {
				"member_id": "DUMMYMEMBERID1234567890",
				"establishment_id": "DUMMYESTID1234",
				"date_of_exit": "",
				"date_of_joining": "2022-09-12",
				"leave_reason": "",
				"establishment_name": "Dummy Company Name",
				"employer_confidence_score": null
			}
		}
	},
	"uanNumbers": [
		"DUMMYUAN123456"
	],
	"uanDataSource": [
		{
			"uan": "DUMMYUAN123456",
			"source": "pan and mobile"
		}
	],
	"epfoFilingDetails": {
		"searchResult": {
			"establishmentName": "Dummy Company Name",
			"establishmentID": "DUMMYESTID1234",
			"address": "123 Dummy Street, Dummy City, Dummy State",
			"officeName": "DUMMYOFFICE"
		},
		"paymentDetails": [
			{
				"match": true,
				"trrn": "DUMMYTRRN123456",
				"dateOfCredit": "15/08/2024",
				"amount": "36,69,234",
				"wageMonth": "07/2024",
				"ecr": "YES",
				"employeeMatch": [
					"Dummy Name"
				]
			},
			{
				"match": true,
				"trrn": "DUMMYTRRN654321",
				"dateOfCredit": "15/07/2024",
				"amount": "47,77,165",
				"wageMonth": "06/2024",
				"ecr": "YES",
				"employeeMatch": [
					"Dummy Name"
				]
			}
		]
	}
}

Output Parameters:

Parameter	Type	Description
resultCode	Integer	HTTP status code, indicating success (200)
employmentSummary.recent_employer_data.member_id	String	Member ID
employmentSummary.recent_employer_data.establishment_id	String	Establishment ID
employmentSummary.recent_employer_data.date_of_exit	String	Date of exit
employmentSummary.recent_employer_data.date_of_joining	String	Date of joining
employmentSummary.recent_employer_data.establishment_name	String	Establishment name
employmentSummary.recent_employer_data.employer_confidence_score	Nullable	Employer confidence score
employmentSummary.recent_employer_data.matching_uan	String	Matching UAN
employmentSummary.recent_employer_data.current_tenure	Integer	Current tenure in months
employmentSummary.matching_uan	String	Matching UAN
employmentSummary.is_employed	Boolean	Indicates whether the employee is currently employed
employmentSummary.employee_name_match	Nullable	Employee name match
employmentSummary.employer_name_match	Nullable	Employer name match
employmentSummary.uan_count	Integer	Count of UAN numbers
employmentSummary.date_of_exit_marked	Boolean	Indicates whether date of exit is marked
uanDetails[uanNumber]basic_details.gender	String	Gender
uanDetails[uanNumber]basic_details.date_of_birth	String	Date of birth
uanDetails[uanNumber]basic_details.employee_confidence_score	Nullable	Employee confidence score
	String	Employee name
uanDetails[uanNumber]basic_details.mobile	String	Mobile number
uanDetails[uanNumber]basic_details.aadhaar_verification_status	Integer	Aadhaar verification status
uanDetails[uanNumber]employment_details.member_id	String	Member ID
uanDetails[uanNumber]employment_details.establishment_id	String	Establishment ID
uanDetails[uanNumber]employment_details.date_of_exit	String	Date of exit
uanDetails[uanNumber]employment_details.date_of_joining	String	Date of joining
uanDetails[uanNumber]employment_details.leave_reason	String	Leave reason
uanDetails[uanNumber]employment_details.establishment_name	String	Establishment name
uanDetails[uanNumber]employment_details.employer_confidence_score	Nullable	Employer confidence score
uanNumbers[i]	String	UAN number
uanDataSource[i].uan	String	UAN number
uanDataSource[i].source	String	UAN data source
epfoFilingDetails.searchResult.establishmentName	String	Establishment name
epfoFilingDetails.searchResult.establishmentID	String	Establishment ID
epfoFilingDetails.searchResult.address	String	Establishment address
epfoFilingDetails.searchResult.officeName	String	Office name
epfoFilingDetails.paymentDetails[i].match	Boolean	Indicates if the employee matches
epfoFilingDetails.paymentDetails[i].trrn	String	TRRN number
epfoFilingDetails.paymentDetails[i].dateOfCredit	String	Date of credit
epfoFilingDetails.paymentDetails[i].amount	String	Amount
epfoFilingDetails.paymentDetails[i].wageMonth	String	Wage month
epfoFilingDetails.paymentDetails[i].ecr	String	ECR flag
epfoFilingDetails.paymentDetails[i].employeeMatch[i]	String	Employee match

Status Codes:

{
    "error": {
        "reason": "VALIDATION_ERROR",
        "status": 400,
        "message": "\"requestBody.mobile\" is not allowed to be empty",
        "type": "Bad Request",
        "statusCode": 400,
        "name": "error"
    }
}
1. "\"mobile\" is not allowed to be empty"
2. "\"panNumber\" length must be 10 characters long"
3. "Invalid phoneNumber",