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

Example:

"9876543210"

​
pan_number
string

PAN in format ABCDE1234F

Example:

"ABCDE1234F"

​
uan_number
string

12-digit Universal Account Number

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