BrandKwikID Documentation
API Suite

EPF UAN Validation

Fetches employment history for a given UAN via KwikID.

EPF UAN Validation

API reference

Try itLoading playground…
Loading…

Authorization

AuthorizationBearer <token>

JWT Bearer token authentication. Obtain a token from the KwikID dashboard.

In: header

Request Body

uanstring

The Universal Account Number.

clientData?object

Custom metadata (wrapper only).

Empty Object

Response Body

curl -X POST "https://__playground__/verification/v3/epf_uan_validation/validate" \  -H "Content-Type: application/json" \  -d '{    "uan": "100987654321"  }'

{
  "success": true,
  "status_code": 200,
  "provider": "KwikID",
  "api_name": "EPF UAN Validation",
  "data": {
    "requestId": "d0c359c5-11b0-40bf-8fce-af4c654ca853",
    "result": {
      "employers": [
        {
          "startMonthYear": "06-2019",
          "lastMonthYear": "10-2019",
          "establishmentName": "CONNEQT BUSINESS SOLUTIONS LIMITED",
          "memberId": "APHYD1489446000006XXXX",
          "status": "EMPLOYMENT_PERIOD_FOUND"
        }
      ],
      "personalDetails": {
        "name": "RUSHIKESH GAJANAN XXXX"
      },
      "summary": {
        "minimumWorkExperienceInMonths": 4
      }
    },
    "statusCode": 101
  }
}
{
  "detail": {},
  "message": "string"
}
{
  "error": "string"
}

Overview

Call POST /verification/v3/epf_uan_validation/validate from your backend when you need to validate a Universal Account Number (UAN) and fetch registered employment history. This API interfaces with the KwikID gateway.

Key features

  • Employment history check: Returns a detailed history of employers, member IDs, work periods, and establishment names.
  • Biometric/demographic checks: Returns the verified full name associated with the EPF UAN.
  • Experience analysis: Provides a computed work experience summary in months.

Implementation

Step 1: Call from your backend

POST /verification/v3/epf_uan_validation/validate HTTP/1.1
Host: <verification-api-base-url>
Authorization: Bearer <token>
Content-Type: application/json

{
  "uan": "100987654321"
}

Step 2: Use the response

On success (200 OK), the response will return detailed employee and employer metadata:

{
  "success": true,
  "status_code": 200,
  "provider": "KwikID",
  "api_name": "EPF UAN Validation",
  "data": {
    "requestId": "d0c359c5-11b0-40bf-8fce-af4c654ca853",
    "result": {
      "employers": [
        {
          "startMonthYear": "06-2019",
          "lastMonthYear": "10-2019",
          "establishmentName": "CONNEQT BUSINESS SOLUTIONS LIMITED",
          "memberId": "APHYD1489446000006XXXX",
          "status": "EMPLOYMENT_PERIOD_FOUND"
        }
      ],
      "personalDetails": {
        "name": "RUSHIKESH GAJANAN XXXX"
      },
      "summary": {
        "minimumWorkExperienceInMonths": 4
      }
    },
    "statusCode": 101
  }
}

Verify OTP and Get Details POST

Complete EPF verification with OTP and session values from login. Returns member data in the response body.

Send Request (E-Sign) POST

Start the hosted e-sign flow and receive a redirection URL. Server-side multipart POST with Bearer auth; includes PDF and session metadata.