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=100123456789&generate_pdf=false" \
  -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": "RAHUL KUMAR SHARMA",
        "guardian_name": "RAJESH KUMAR SHARMA",
        "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
Base URLstring

Target server for requests. Edit to use your own host.

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

uan_numberstring
Required
Example:
100123456789
generate_pdfboolean
Example:
false

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.