Employment Verification V2

Introduction

The Employment Verification API is designed to provide recent employment information for an individual based on their Mobile Number and PAN (Permanent Account Number) details.

This API fetches essential employment-related data, including the company name, member ID, date of joining, date of exit, and the Universal Account Number (UAN) associated with the provided input.

API details

Endpoint:

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

Request Method:

Mobile Number as Input.

Mobile Number and PAN as Input.

PAN as input

Request body parameter:

Parameter	Data Type	Description	Required
mobileNumber	String	10-digit Mobile number	CO
panNumber	String	PAN (Permanent Account Number) of the individual.	CO

M - Mandatory; O- Optional; CO- Conditional Optional Note: You have to at least one of the parameters

Sample Response:

{
    "resultCode": 200,
    "employmentSummary": {
        "recent_employer_data": {
            "member_id": "RNDM17530220000010530",
            "establishment_id": "RNDM1753022000",
            "date_of_exit": "",
            "date_of_joining": "2023-09-04",
            "establishment_name": "Random Technologies Pvt Ltd",
            "employer_confidence_score": null,
            "matching_uan": "123456789012"
        },
        "is_employed": true,
        "employee_name_match": null,
        "employer_name_match": null,
        "uan_count": 2,
        "date_of_exit_marked": false
    },
    "uanDetails": [
        {
            "uan": "098765432109",
            "basic_details": {
                "gender": "MALE",
                "date_of_birth": "1992-04-03",
                "employee_confidence_score": null,
                "name": "John Doe",
                "mobile": "",
                "aadhaar_verification_status": 1
            },
            "employment_details": {
                "member_id": "ABCD16582860000010527",
                "establishment_id": "ABCD1658286000",
                "date_of_exit": "2018-04-27",
                "date_of_joining": "2017-11-01",
                "leave_reason": "",
                "establishment_name": "XYZ Finance Ltd",
                "employer_confidence_score": null
            }
        },
        {
            "uan": "123456789012",
            "basic_details": {
                "gender": "MALE",
                "date_of_birth": "1992-04-03",
                "employee_confidence_score": null,
                "name": "Jane Doe",
                "mobile": "",
                "aadhaar_verification_status": 1
            },
            "employment_details": {
                "member_id": "RNDM17530220000010530",
                "establishment_id": "RNDM1753022000",
                "date_of_exit": "",
                "date_of_joining": "2023-09-04",
                "leave_reason": "",
                "establishment_name": "Random Technologies Pvt Ltd",
                "employer_confidence_score": null
            }
        }
    ],
    "uanNumbers": [
        "098765432109",
        "123456789012"
    ],
    "uanDataSource": [
        {
            "uan": "123456789012",
            "source": "mobile"
        },
        {
            "uan": "098765432109",
            "source": "pan and mobile"
        }
    ]
}

Response body parameters:

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	Array	Detailed information about the provided Universal Account Numbers.
uanDetails[index]	Object	Basic and employment details about the employee associated with the provided UAN.
uanDetails[index].uan	string	UAN Number of the employee
uanDetails.[index].basic_details	Object	Basic information about the employee.
uanDetails.[index].basic_details.gender	String	Gender of the employee.
uanDetails.[index].basic_details.date_of_birth	String	Date of birth of the employee in format (YYYY-MM-DD).
uanDetails.[index].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.[index].basic_details.name	String	Name of the employee.
uanDetails.[index].basic_details.mobile	String	Mobile number of the employee.

uanDetails.[index].employment_details	Object	Detailed information about the employee's employment associated with the provided UAN.
uanDetails.[index].employment_details.member_id	String	Member ID associated with the individual's employment.
uanDetails.[index].employment_details.establishment_id	String	Establishment ID associated with the individual's employment.
uanDetails.[index].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.[index].employment_details.date_of_joining	String	Date of joining the provided company in format (YYYY-MM-DD).
uanDetails.[index].employment_details.leave_reason	String	Reason for leaving employment, if applicable.
uanDetails.[index].employment_details.establishment_name	String	Name of the establishment where the individual is employed.
uanDetails.[index].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!