Skip to main content
POST
/
v2
/
verification
/
epfo
curl --request POST \ --url https://bgv.konnectnxt.com/api/v2/verification/epfo/ \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "phone_number": "9876543210", "pan_number": "ABCDE1234F", "uan_number": "100234567890", "employer_name": "Tech Solutions Pvt Ltd", "employee_name": "Priya Sharma" } '
{ "status": "success", "code": 200, "message": "Operation completed successfully", "data": { "is_employed": true, "is_employee_name_match": true, "is_employer_name_match": true, "recent_employer_data": { "date_of_exit": null, "date_of_joining": "2023-03-15", "employer_confidence_score": 0.95, "establishment_id": "MHPUN0123456789", "establishment_name": "TECH SOLUTIONS PVT LTD", "matching_uan": "100234567890", "member_id": "MHPUN01234567890012345" }, "status": "id_found", "uan": [ "100234567890" ], "uan_details": { "100234567890": { "basic_details": { "aadhaar_verification_status": 1, "date_of_birth": "1992-07-20", "employee_confidence_score": 1, "gender": "FEMALE", "mobile": "9876543210", "name": "PRIYA SHARMA" }, "employment_details": { "date_of_exit": null, "date_of_joining": "2023-03-15", "employer_confidence_score": 0.95, "establishment_id": "MHPUN0123456789", "establishment_name": "TECH SOLUTIONS PVT LTD", "leave_reason": "", "member_id": "MHPUN01234567890012345" } } } }, "credits_used": 20, "credits_remaining": 9980.5 }

​
Overview

This API verifies employment history through EPFO (Employees’ Provident Fund Organisation) records. Most verifications complete immediately, but longer requests return a request_id for polling.

​
Required Information

At least ONE of the following:
  • UAN number (12 digits)
  • PAN number (format: ABCDE1234F)
  • Phone number (10 digits)

​
Optional Information

Providing these details improves matching accuracy:
  • Employee name
  • Employer name

​
Response Types

​
Synchronous (Status 200)

Most verifications complete within 5 seconds and return full employment data immediately.

​
Asynchronous (Status 202)

If processing takes longer, you’ll receive a request_id. Use the Task Status endpoint to poll for results.

​
Response Data

  • Current employment status
  • UAN details and basic information
  • Employment history with dates
  • Employer details and confidence scores
  • Name matching results

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request for EPFO employment verification - requires at least ONE identifier

​
phone_number
string

10-digit mobile number linked with UAN

Pattern: ^[6-9]\d{9}$
Example:

"9876543210"

​
pan_number
string

PAN in format ABCDE1234F

Pattern: ^[A-Z]{5}[0-9]{4}[A-Z]$
Example:

"ABCDE1234F"

​
uan_number
string

12-digit Universal Account Number

Pattern: ^\d{12}$
Example:

"100234567890"

​
employer_name
string

Current or recent employer name (optional, improves matching)

Maximum string length: 255
Example:

"Tech Solutions Pvt Ltd"

​
employee_name
string

Employee full name (optional, used for verification match)

Maximum string length: 255
Example:

"Priya Sharma"

Response

Verification completed successfully

​
status
enum<string>
required

Overall status of the API

Available options:
success,
error
​
code
integer
required

HTTP status code

Example:

400

​
message
string
required

Description of the response or error

Example:

"Invalid request parameters"

​
credits_used
integer
required

Represents the total number of credits used in this request.

Example:

3

​
credits_left
integer
required

Represents the remaining credits available for use.

Example:

4040

​
data
object