Skip to main content
GET
/
verification
/
get-employment-history
cURL
curl --request GET \
  --url https://bgv.konnectnxt.com/api/verification/get-employment-history \
  --header 'Authorization: Bearer <token>'
{
  "status": "success",
  "code": 200,
  "message": "Data Fetched Successfully.",
  "data": {
    "case_id": "8a3b2d79e91c4ff1b2e97b9f2b36c123",
    "personal_details": {
      "user_gender": "MALE",
      "user_dob": "23-08-1999",
      "user_full_name": "John Doe",
      "user_phone_number": "9101010101"
    },
    "employment_history": [
      {
        "sequence_number": "1",
        "uan_number": "100342762111",
        "date_of_exit": "NA",
        "date_of_joining": "30-03-2015",
        "establishment_id": "PYKRP00139620000023393",
        "establishment_name": "ABC Pvt Ltd",
        "member_id": "PBK0012345678",
        "exit_reason": "NA",
        "mobile": "NA",
        "aadhaar_verification_status": ""
      }
    ]
  },
  "credits_used": 1,
  "credits_remaining": 499
}
Due to EPFO restrictions, this API can only provide the candidate’s last employment record. Full employment history is no longer available.
This API retrieves a candidate’s past employment details using a valid 10-digit Indian mobile number. When you supply the mobile number, the API fetches basic personal information—such as full name, gender, and date of birth—and returns a list of previous employers, including details like joining and exit dates, employer names, and identification numbers. Essentially, it streamlines the process of obtaining verified work history data, which can be useful for background checks and employment verification purposes.
You will be charged for API calls regardless of the response, including both 200 (successful) and 404 (not found) status codes.

Authorizations

​
Authorization
string
header
required

API key issued by KonnectNXT. Pass as Authorization: Bearer <your_api_key>.

Query Parameters

​
mobile
string
required

The 10-digit Indian mobile number of the candidate.

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

"9990191919"

Response

Successful response with employment history details.

​
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"

​
data
object
required
​
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