> For the complete documentation index, see [llms.txt](https://docs.tutelar.io/tutelar-api-document/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tutelar.io/tutelar-api-document/kyc-verification/assets-verification/india/employment-history-details.md).

# 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

<mark style="color:green;">`POST`</mark> `https://secctrl.tutelar.io/api/v1/kyc/banking/employment_history`

### Post parameters description is given below,

<table><thead><tr><th width="147.953125">Post Parameter </th><th width="81.5625">Type</th><th width="133.0234375">Is Mandatory</th><th>Dependency Condition</th><th width="144.98046875">Description</th></tr></thead><tbody><tr><td> uanNumber</td><td>String </td><td>Conditional Mandatory</td><td>Either uanNumber, panNumber or mobileNumber is Required</td><td>UAN Number</td></tr><tr><td>panNumber</td><td>String</td><td>Conditional Mandatory</td><td>Either uanNumber, panNumber or mobileNumber is Required</td><td>PAN Number</td></tr><tr><td>mobileNumber</td><td>String</td><td>Conditional Mandatory</td><td>Either uanNumber, panNumber or mobileNumber is Required</td><td>Mobile Number </td></tr><tr><td>employeeName</td><td>String</td><td>Optional</td><td>Employee Name is not required</td><td>Employee Name</td></tr></tbody></table>

#### Sample Post Parameters

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

{% tabs %}
{% tab title="200: Success Response" %}

```json
{
  "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"
}
```

{% endtab %}

{% tab title="200: InProgress Response" %}

```json
{
    "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"
}
```

{% endtab %}

{% tab title="400: Validation Error Response" %}

```json
{
    "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"
    }
}
```

{% endtab %}

{% tab title="200: Failure Response" %}

```json
{
    "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"
}
```

{% endtab %}
{% endtabs %}

## &#x20;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

<mark style="color:blue;">`GET`</mark> `https://secctrl.tutelar.io/api/v1/kyc/banking/employment_history`

### Query parameters description is given below,

<table><thead><tr><th width="197">Query Parameter </th><th width="139">Type</th><th>Is  Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>reference_id </td><td>String </td><td>Yes </td><td>Reference Id</td></tr></tbody></table>

{% tabs %}
{% tab title="200: Success Response" %}

```json
{
  "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"
}
```

{% endtab %}

{% tab title="200: InProgress Response" %}

```json
{
    "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"
}
```

{% endtab %}

{% tab title="200: Failure Response" %}

```json
{
    "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"
}
```

{% endtab %}
{% endtabs %}