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.
POST https://secctrl.tutelar.io/api/v1/kyc/banking/uan_advance
Post parameters description is given below,
1) Search By UAN Number
Post Parameter
Type
Is Mandatory
Dependency Condition
Description
uan_number
String
Yes
-
UAN Number
employee_name
String
No
-
Employee Name
employer_name
String
No
If employer_name is provided, then employee_name is mandatory
Employer Name
2) Search By Lookups
Post Parameter
Type
Is Mandatory
Dependency Condition
Description
mobile_number
String
Yes ( Conditional Mandatory )
If pan_number is provided mobile_number is not mandatory
UAN Number
pan_number
String
Yes ( Conditional Mandatory )
If mobile_number is provided pan_number is not mandatory
Pan Number
date_of_birth
String
No
If date_of_birth is provided, then employee_name is mandatory
Date of birth - format should be YYYY-MM-DD
employee_name
String
No
-
Employee Name
employer_name
String
No
If employer_name is provided, then employee_name is mandatory
Employer Name
Sample Post Parameters
{
"uan_number": "100782123456",
"employee_name": "Subin Balachandran",
"employer_name": "Tutelar Solutions Private Limited"
}{
"mobile_number": "9560104070",
"pan_number": "CNMPS6020K",
"date_of_birth": "1991-09-07"
"employee_name": "Subin Balachandran",
"employer_name": "Tutelar Solutions Private Limited"
}
{
"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***************[email protected]",
"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"
}{
"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"
}{
"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"
}
}
{
"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"
}
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
GET https://secctrl.tutelar.io/api/v1/kyc/banking/uan_advance
Query parameters description is given below,
Query Parameter
Type
Is Mandatory
Description
reference_id
String
Yes
Document reference id
"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***************[email protected]",
"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"
}{
"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"
}{
"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"
}
Last updated