Basic Employment Verification V2

Introduction

Basic Employment Verification

Introduction

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.

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.

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

API description

API Endpoint's

POST https://api.signzy.app/api/v3/api/basic-employment-verification

Headers

Key	Value
Authorization	access token (returned as id field of login request)
Content-type	application/json

{
    "mobileNumber": "8008331337",
    "panNumber": "DFYPK1218G",
    "uanNumber": "",
    "dateOfBirth": "",
    "employeeName": "",
    "employerName": "",
    "nameMatchMethod": ""
}

Details of the reque properties

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

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

{
    "result": {
        "uan": [
            "100974202120"
        ],
        "summary": {
            "recentEmployerData": {
                "memberId": "PUPUN17530220000010149",
                "establishmentId": "PUPUN1753022000",
                "dateOfExit": "",
                "dateOfJoining": "2020-10-09",
                "establishmentName": "Signzy Technologies Private Limited",
                "employerConfidenceScore": null,
                "matchingUan": "100974202120"
            },
            "isEmployed": true,
            "employeeNameMatch": null,
            "employerNameMatch": null,
            "uanCount": 1,
            "dateOfExitMarked": false
        },
        "uanDetails": {
            "100974202120": {
                "basicDetails": {
                    "gender": "MALE",
                    "dateOfBirth": "1992-07-10",
                    "employeeConfidenceScore": null,
                    "name": "Kasukurti Ramakrishna",
                    "mobile": "",
                    "aadhaarVerificationStatus": 1
                },
                "employmentDetails": {
                    "memberId": "PUPUN17530220000010149",
                    "establishmentId": "PUPUN1753022000",
                    "dateOfExit": "",
                    "dateOfJoining": "2020-10-09",
                    "leaveReason": "",
                    "establishmentName": "Signzy Technologies Private Limited",
                    "employerConfidenceScore": null
                }
            }
        },
        "uanSource": [
            {
                "uan": "100974202120",
                "source": "mobile"
            }
        ],
        "nameDobFilteringScore": null
    }
}

Details of the response properties

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.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 Codes

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.

Basic Employment Verification V2

Introduction