EPFOUAN To Employment History - V2

Employment History by UAN — EPFO Records

Retrieve the full employment history linked to a UAN — employer names, joining/exit dates, and PF contributions from EPFO records.

curl -X GET "https://production.deepvue.tech/v2/verification/epfo/uan-to-employment-history?uan_number=example_string&generate_pdf=true" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN (JWT)" \
  -H "x-api-key: YOUR_API_KEY"
{
  "code": 200,
  "timestamp": 1738342015371,
  "transaction_id": "a00ad6a679d549d6bd002afdf2b226c0",
  "sub_code": "SUCCESS",
  "message": "Employment History fetched successfully",
  "data": {
    "pdf_url": null,
    "employment_history": [
      {
        "name": "TAHIR AHMED CHOUDHURY",
        "guardian_name": "JOBUR AHMED CHOUDHURY",
        "establishment_name": "MODERN VEER RAYS SECURITY FORCE (INDIA) PVT LTD",
        "member_id": "BGBNG00420230000027886",
        "date_of_joining": "2024-04-12",
        "date_of_exit": null,
        "last_pf_submitted": "2025-01-15"
      }
    ]
  }
}
GET
/v2/verification/epfo/uan-to-employment-history
GET
Bearer Token (JWT)
Bearer Tokenstring
Required

ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .

ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .
API Key (header: x-api-key)
x-api-keystring
Required

The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.

The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token (JWT). ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .

header
x-api-keystring
Required

API Key for authentication. The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.

Query Parameters

Responses

codeinteger
timestampinteger
transaction_idstring
sub_codestring
messagestring
dataobject

Overview

This API retrieves comprehensive employment history records linked to a Universal Account Number (UAN). You can use this endpoint to fetch detailed employment data associated with a given UAN identifier.

What's new in V2

The V2 iteration introduces three notable improvements over the previous version:

  • Better uptime -- Backend enhancements ensure more consistent availability.
  • Reduced source failures -- Improved handling of upstream dependencies for smoother performance.
  • Date of exit -- Get clearer employment histories with the newly added date_of_exit field in each record.

Successful requests return either employment history records or a notification that no linked history exists for the provided UAN. Both responses carry an HTTP 200 status code.