Employment History Details

Retrieves all UANs linked to a given PAN and/or mobile number, fetches associated employment history records, and computes a name-match score against the user-provided name to verify identity accuracy.

employment_history

POST https://secctrl.tutelar.io/api/v1/kyc/banking/employment_history

Post parameters description is given below,

Post Parameter

Type

Is Mandatory

Dependency Condition

Description

uanNumber

String

Conditional Mandatory

Either uanNumber, panNumber or mobileNumber is Required

UAN Number

panNumber

String

Conditional Mandatory

Either uanNumber, panNumber or mobileNumber is Required

PAN Number

mobileNumber

String

Conditional Mandatory

Either uanNumber, panNumber or mobileNumber is Required

Mobile Number

employeeName

String

Optional

Employee Name is not required

Employee Name

Sample Post Parameters

{
    "uanNumber":  "102040138045", //Conditional Mandatory
    "panNumber": "MDQPS6020K", //Conditional Mandatory
    "mobileNumber": "9360104074", //Conditional Mandatory
    "employeeName": "Siva" //Optional
}

{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "02776c8c-30e7-4cee-a2c0-dbdfddfe2188",
    "status": "completed",
    "result": {
        "uanNumber": "102040138xxx",
        "employmentHistory": [
            {
                "name": "MANIKANDAN SIVA",
                "establishmentName": "ACCUPAYD TECH PRIVATE LIMITED",
                "memberId": "MDMDU263066800000100xxx",
                "dateOfJoining": "2025-04-01",
                "nameMatchScore": "0.0"
            },
            {
                "name": "MANIKANDAN SIVA",
                "establishmentName": "IPPOPAY TECHNOLOGIES PRIVATE LIMITED",
                "memberId": "TNAMB223749300000110xxx",
                "dateOfJoining": "2024-01-01",
                "dateOfExit": "2025-03-31",
                "nameMatchScore": "0.0"
            }
        ]
    },
    "requested_at": "2026-07-02T14:54:18.841Z",
    "completed_at": "2026-07-02T14:54:19.872Z"
}

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "170f899a-eb74-4098-989b-23998066ce12",
    "status": "in_progress",
    "requested_at": "2026-07-03T06:29:15.037Z"
}

{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Provide either UAN, PAN, or Mobile Number",
        "field": "",
        "code": "BAD_REQUEST"
    }
},
{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "UAN should contain 12 digits",
        "field": "uanNumber",
        "code": "BAD_REQUEST"
    }
},
{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Invalid PAN Number",
        "field": "panNumber",
        "code": "BAD_REQUEST"
    }
},
{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Invalid Mobile Number",
        "field": "mobileNumber",
        "code": "BAD_REQUEST"
    }
},
{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Employee name should be between 3 and 50 characters",
        "field": "employeeName",
        "code": "BAD_REQUEST"
    }
}

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "0204193f-021e-4443-9734-586f23f17d00",
    "status": "failed",
    "error": {
        "message": "No UAN found for the provided input.",
        "code": "ERROR"
    },
    "requested_at": "2026-07-02T13:51:27.950Z",
    "completed_at": "2026-07-02T13:51:28.826Z"
},
{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "9639051b-a96a-46ea-abd4-f2b1ed596ddb",
    "status": "failed",
    "error": {
        "message": "Invalid details were provided. Please submit valid details.",
        "code": "ERROR"
    },
    "requested_at": "2026-07-03T06:29:15.037Z",
    "completed_at": "2026-07-03T06:29:16.471Z"
}

Get details

This Get details API using to fetch the latest updated response when the above API gave the status as in-progress by using the reference_id

GET https://secctrl.tutelar.io/api/v1/kyc/banking/employment_history

Query parameters description is given below,

Query Parameter

Type

Is Mandatory

Description

reference_id

String

Yes

Reference Id

{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "02776c8c-30e7-4cee-a2c0-dbdfddfe2188",
    "status": "completed",
    "result": {
        "uanNumber": "102040138xxx",
        "employmentHistory": [
            {
                "name": "MANIKANDAN SIVA",
                "establishmentName": "ACCUPAYD TECH PRIVATE LIMITED",
                "memberId": "MDMDU263066800000100xxx",
                "dateOfJoining": "2025-04-01",
                "nameMatchScore": "0.0"
            },
            {
                "name": "MANIKANDAN SIVA",
                "establishmentName": "IPPOPAY TECHNOLOGIES PRIVATE LIMITED",
                "memberId": "TNAMB223749300000110xxx",
                "dateOfJoining": "2024-01-01",
                "dateOfExit": "2025-03-31",
                "nameMatchScore": "0.0"
            }
        ]
    },
    "requested_at": "2026-07-02T14:54:18.841Z",
    "completed_at": "2026-07-02T14:54:19.872Z"
}

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "170f899a-eb74-4098-989b-23998066ce12",
    "status": "in_progress",
    "requested_at": "2026-07-03T06:29:15.037Z"
}

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "0204193f-021e-4443-9734-586f23f17d00",
    "status": "failed",
    "error": {
        "message": "No UAN found for the provided input.",
        "code": "ERROR"
    },
    "requested_at": "2026-07-02T13:51:27.950Z",
    "completed_at": "2026-07-02T13:51:28.826Z"
},
{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "9639051b-a96a-46ea-abd4-f2b1ed596ddb",
    "status": "failed",
    "error": {
        "message": "Invalid details were provided. Please submit valid details.",
        "code": "ERROR"
    },
    "requested_at": "2026-07-03T06:29:15.037Z",
    "completed_at": "2026-07-03T06:29:16.471Z"
}

PreviousVehicle Reverse RC NextFace and Document Verification

Last updated 12 days ago