Employement Verification Stack
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:
preproduction
production
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"
}'
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:
JSON
{
    "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"
        }
    ]
}

{
    "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].basic_details.aadhaar_verification_status
Integer
The Aadhaar verification status of the employee (1 indicates verified).
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!
﻿
﻿
Basic Employment Verification V2
Current Employer Advanced
Docs powered by Archbee
TABLE OF CONTENTS
Request body parameter:
Sample Response:
Response body parameters:
Parameter	Data Type	Description	Required
mobileNumber	String	10-digit Mobile number	CO
panNumber	String	PAN (Permanent Account Number) of the individual.	CO
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