> 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/uan-advance.md).

# UAN Advance

The UAN (Universal Account Number) Advance API is a specialized tool designed to facilitate seamless access to advance payment features associated with UANs. This API additionally provides EPFO pf filing details, which differ from the UAN basic API.

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

### Post parameters description is given below,

**1) Search By UAN Number**

<table><thead><tr><th width="158.3515625">Post Parameter </th><th width="92.390625">Type</th><th width="160.4375">Is  Mandatory</th><th width="170.0546875">Dependency Condition</th><th>Description</th></tr></thead><tbody><tr><td> uan_number</td><td>String </td><td>Yes</td><td>                -</td><td>UAN Number</td></tr><tr><td>employee_name</td><td>String</td><td>No</td><td>                -</td><td>Employee Name</td></tr><tr><td>employer_name</td><td>String</td><td>No</td><td>If  <strong>employer_name</strong> is provided, then <strong>employee_name</strong> is mandatory</td><td>Employer Name</td></tr></tbody></table>

**2) Search By Lookups**

<table><thead><tr><th width="152.40234375">Post Parameter </th><th width="105.078125">Type</th><th>Is  Mandatory</th><th width="166.33203125">Dependency Condition</th><th>Description</th></tr></thead><tbody><tr><td> mobile_number</td><td>String </td><td>Yes ( Conditional Mandatory )</td><td>If <strong>pan_number</strong> is provided <strong>mobile_number</strong> is not mandatory</td><td>UAN Number</td></tr><tr><td>pan_number</td><td>String</td><td>Yes ( Conditional Mandatory )</td><td>If <strong>mobile_number</strong> is provided <strong>pan_number</strong> is not mandatory</td><td>Pan Number</td></tr><tr><td>date_of_birth</td><td>String</td><td>No</td><td>If <strong>date_of_birth</strong> is provided, then <strong>employee_name</strong> is mandatory</td><td>Date of birth - format should be <strong>YYYY-MM-DD</strong></td></tr><tr><td>employee_name</td><td>String</td><td>No</td><td>                -</td><td>Employee Name</td></tr><tr><td>employer_name</td><td>String</td><td>No</td><td>If <strong>employer_name</strong> is provided, then <strong>employee_name</strong> is mandatory</td><td>Employer Name</td></tr></tbody></table>

#### Sample Post Parameters

{% tabs %}
{% tab title="Search By UAN Number" %}

```json
{
   "uan_number": "100782123456",
   "employee_name": "Subin Balachandran",
   "employer_name": "Tutelar Solutions Private Limited"
}
```

{% endtab %}

{% tab title="Search By Lookups" %}

```json
{
   "mobile_number": "9560104070",
   "pan_number": "CNMPS6020K",
   "date_of_birth": "1991-09-07"
   "employee_name": "Subin Balachandran",
   "employer_name": "Tutelar Solutions Private Limited"
}

```

{% endtab %}
{% endtabs %}

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

```json
{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "a0bb170f-c250-4d55-8ccc-6b2725a328ea",
    "status": "completed",
    "result": {
        "summary": {
            "recent_employer_data": {
                "member_id": "TBTAM24160940000012345",
                "establishment_id": "TBTAM241609000",
                "date_of_exit": "2025-04-03",
                "date_of_joining": "2025-04-03",
                "establishment_name": "VIVEKA RISK MANAGEMENT SERVICES PRIVATE LIMITED",
                "employer_confidence_score": null,
                "matching_uan": "100782123456"
            },
            "matching_uan": "100782123456",
            "is_employed": false,
            "employee_name_match": null,
            "employer_name_match": null,
            "uan_count": 2,
            "date_of_exit_marked": true
        },
        "uan_details": [
            {
                "uan_number": "100782182345",
                "basic_details": {
                    "gender": "MALE",
                    "date_of_birth": "1991-09-07",
                    "employee_confidence_score": null,
                    "name": "Subin Balachandran",
                    "mobile": "",
                    "aadhaar_verification_status": true
                },
                "employment_details": {
                    "member_id": "TBTAM24160940000010033",
                    "establishment_id": "TBTAM2416094000",
                    "date_of_exit": "2025-04-03",
                    "date_of_joining": "2025-04-03",
                    "leave_reason": "",
                    "establishment_name": "VIVEKA RISK MANAGEMENT SERVICES PRIVATE LIMITED",
                    "employer_confidence_score": null
                },
                "additional_details": {
                    "aadhaar": "",
                    "member_id": "TBTAM24160940000010033",
                    "email": "b***************n@gmail.com",
                    "pan": "",
                    "bank_ifsc": "HDFC*****47",
                    "bank_acc_no": "**********1622",
                    "bank_address": "HDFC BANK,CHENNAI - THIRUVANMIYUR",
                    "relation": "F",
                    "relative_name": "P Balachandran"
                }
            },
            {
                "uan_number": "100782182345",
                "basic_details": {
                    "gender": "MALE",
                    "date_of_birth": "1991-09-07",
                    "employee_confidence_score": null,
                    "name": "Subin  Balachandran",
                    "mobile": "",
                    "aadhaar_verification_status": true
                },
                "employment_details": {
                    "member_id": "TBTAM00496940000127524",
                    "establishment_id": "TBTAM0049694000",
                    "date_of_exit": "2016-06-02",
                    "date_of_joining": "2016-02-22",
                    "leave_reason": "",
                    "establishment_name": "SUTHERLAND GLOBAL SERVICES P LTD",
                    "employer_confidence_score": null
                },
                "additional_details": {
                    "aadhaar": "",
                    "member_id": "TBTAM00496940000127524",
                    "email": "",
                    "pan": "CN******4A",
                    "bank_ifsc": "HDFC*****47",
                    "bank_acc_no": "**********1622",
                    "bank_address": "HDFC BANK,CHENNAI - THIRUVANMIYUR",
                    "relation": "F",
                    "relative_name": "BALACHANDRAN P"
                }
            }
        ],
        "epfo": {
            "is_recent": false,
            "is_name_unique": false,
            "has_pf_filings_details": true
        },
        "epfo_pf_filling_details": [
            {
                "total_amount": 207673,
                "employees_count": 63,
                "wage_month": "AUG-25"
            },
            {
                "total_amount": 176852,
                "employees_count": 56,
                "wage_month": "JUL-25"
            },
            {
                "total_amount": 173101,
                "employees_count": 55,
                "wage_month": "JUN-25"
            }
        ]
    },
    "requested_at": "2025-10-07T06:24:35.658Z",
    "completed_at": "2025-10-07T06:24:35.924Z"
}
```

{% endtab %}

{% tab title="200: In Progress" %}

```json
{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "a0bb170f-c250-4d55-8ccc-6b2725a328ea",
    "status": "in_progress",
    "requested_at": "2025-10-07T06:24:35.658Z"
}
```

{% endtab %}

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

```json
{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Please 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 digit number",
        "field": "uan_number",
        "code": "BAD_REQUEST"
    }
}

{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Employer Name cannot be provided if Employee Name is empty",
        "field": "employer_name",
        "code": "BAD_REQUEST"
    }
}

{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Invalid Pan Number",
        "field": "pan_number",
        "code": "BAD_REQUEST"
    }
}

{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Invalid Mobile Number",
        "field": "mobile_number",
        "code": "BAD_REQUEST"
    }
}

{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Date of Birth must be in yyyy-mm-dd format",
        "field": "date_of_birth",
        "code": "BAD_REQUEST"
    }
}

{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Employee name should not be empty when date of birth is provided.",
        "field": "",
        "code": "BAD_REQUEST"
    }
}

{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Employer Name cannot be provided if Employee Name is empty",
        "field": "employer_name",
        "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": "a0bb170f-c250-4d55-8ccc-6b2725a328ea",
    "status": "failed",
    "error": {
        "message": "No record(s) found",
        "code": "ERROR"
    },
    "requested_at": "2025-10-07T07:44:34.465Z",
    "completed_at": "2025-10-07T07:44:34.858Z"
}

```

{% endtab %}
{% endtabs %}

## Get Request 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/uan_advance`

### 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>Document reference id</td></tr></tbody></table>

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

```json
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "a0bb170f-c250-4d55-8ccc-6b2725a328ea",
    "status": "completed",
    "result": {
        "summary": {
            "recent_employer_data": {
                "member_id": "TBTAM24160940000012345",
                "establishment_id": "TBTAM241609000",
                "date_of_exit": "2025-04-03",
                "date_of_joining": "2025-04-03",
                "establishment_name": "VIVEKA RISK MANAGEMENT SERVICES PRIVATE LIMITED",
                "employer_confidence_score": null,
                "matching_uan": "100782123456"
            },
            "matching_uan": "100782123456",
            "is_employed": false,
            "employee_name_match": null,
            "employer_name_match": null,
            "uan_count": 2,
            "date_of_exit_marked": true
        },
        "uan_details": [
            {
                "uan_number": "100782182345",
                "basic_details": {
                    "gender": "MALE",
                    "date_of_birth": "1991-09-07",
                    "employee_confidence_score": null,
                    "name": "Subin Balachandran",
                    "mobile": "",
                    "aadhaar_verification_status": true
                },
                "employment_details": {
                    "member_id": "TBTAM24160940000010033",
                    "establishment_id": "TBTAM2416094000",
                    "date_of_exit": "2025-04-03",
                    "date_of_joining": "2025-04-03",
                    "leave_reason": "",
                    "establishment_name": "VIVEKA RISK MANAGEMENT SERVICES PRIVATE LIMITED",
                    "employer_confidence_score": null
                },
                "additional_details": {
                    "aadhaar": "",
                    "member_id": "TBTAM24160940000010033",
                    "email": "b***************n@gmail.com",
                    "pan": "",
                    "bank_ifsc": "HDFC*****47",
                    "bank_acc_no": "**********1622",
                    "bank_address": "HDFC BANK,CHENNAI - THIRUVANMIYUR",
                    "relation": "F",
                    "relative_name": "P Balachandran"
                }
            },
            {
                "uan_number": "100782182345",
                "basic_details": {
                    "gender": "MALE",
                    "date_of_birth": "1991-09-07",
                    "employee_confidence_score": null,
                    "name": "Subin  Balachandran",
                    "mobile": "",
                    "aadhaar_verification_status": true
                },
                "employment_details": {
                    "member_id": "TBTAM00496940000127524",
                    "establishment_id": "TBTAM0049694000",
                    "date_of_exit": "2016-06-02",
                    "date_of_joining": "2016-02-22",
                    "leave_reason": "",
                    "establishment_name": "SUTHERLAND GLOBAL SERVICES P LTD",
                    "employer_confidence_score": null
                },
                "additional_details": {
                    "aadhaar": "",
                    "member_id": "TBTAM00496940000127524",
                    "email": "",
                    "pan": "CN******4A",
                    "bank_ifsc": "HDFC*****47",
                    "bank_acc_no": "**********1622",
                    "bank_address": "HDFC BANK,CHENNAI - THIRUVANMIYUR",
                    "relation": "F",
                    "relative_name": "BALACHANDRAN P"
                }
            }
        ],
        "epfo": {
            "is_recent": false,
            "is_name_unique": false,
            "has_pf_filings_details": true
        },
        "epfo_pf_filling_details": [
            {
                "total_amount": 207673,
                "employees_count": 63,
                "wage_month": "AUG-25"
            },
            {
                "total_amount": 176852,
                "employees_count": 56,
                "wage_month": "JUL-25"
            },
            {
                "total_amount": 173101,
                "employees_count": 55,
                "wage_month": "JUN-25"
            }
        ]
    },
    "requested_at": "2025-10-07T06:24:35.658Z",
    "completed_at": "2025-10-07T06:24:35.924Z"
}
```

{% endtab %}

{% tab title="200: In Progress" %}

```json
{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "a0bb170f-c250-4d55-8ccc-6b2725a328ea",
    "status": "in_progress",
    "requested_at": "2025-10-07T06:24:35.658Z"
}
```

{% endtab %}

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

```json
{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "a0bb170f-c250-4d55-8ccc-6b2725a328ea",
    "status": "failed",
    "error": {
        "message": "No record(s) found",
        "code": "ERROR"
    },
    "requested_at": "2025-10-07T07:44:34.465Z",
    "completed_at": "2025-10-07T07:44:34.858Z"
}

```

{% endtab %}
{% endtabs %}