Eko Platform Services Logo
    ← Back to Home

    Employee Verification API for Employment History Checks in India

    Verify employment history using phone number-based employee verification. Retrieve details such as employee name, PAN, UAN, Member ID, employer information, joining and exit dates, exit reason, and PF filing details for hiring, lending, staffing, and workforce onboarding workflows.

    Get Sandbox Access View Documentation

    Starts at ₹6.00 per verification · excl. GSTView Pricing

    Employee Verification API for Employment History Checks in India

    Overview

    The Employee Verification API enables organizations to verify employee identity and related details digitally during hiring and onboarding. It is designed to reduce hiring risk, improve compliance, and streamline workforce verification workflows.

    What Can You Verify With Employee Verification API?

    Key details returned across all Employee Verification API endpoints, ready to power your KYC and onboarding workflows.

    UAN Records

    List of UAN records associated with the employee's phone number. One entry per UAN.

    Universal Account Number (UAN)

    Universal Account Number assigned to the employee by EPFO.

    Basic Details

    Core identity details of the employee linked to this UAN.

    Employee Name

    Full name of the employee as registered with EPFO.

    Gender

    Gender of the employee.

    Employee's DOB

    Date of birth of the employee in YYYY-MM-DD format.

    Is Aadhaar Verified?

    Whether the employee's Aadhaar is linked and verified against this UAN.

    Employment Details

    Employment record associated with this UAN entry.

    Member Id

    PF Member ID for this employment record (state/region/establishment/account format).

    Establishment Id

    EPFO establishment ID of the employer.

    Establishment Name

    Name of the employer/establishment as registered with EPFO.

    Joining Date

    Date the employee joined this establishment (YYYY-MM-DD).

    Exit Date

    Date the employee exited this establishment (YYYY-MM-DD). Null if currently employed.

    Leave Reason

    Reason for exit as recorded in EPFO (e.g., Resignation, Superannuation).

    PAN Number

    PAN number linked to the employee.

    Recent Employment Details

    Structured summary of the most recent employment, including EPFO health indicators and employer PF filing history.

    Employee Details

    Latest employment record for the employee with EPFO flags.

    Is Currently Employed?

    Whether the employee is currently active in this establishment per EPFO records.

    Exit Date Marked

    Whether the employer has formally marked an exit date in EPFO.

    Employee Name Match

    Whether the name in EPFO matches the name provided or derived from the phone lookup.

    Epfo

    EPFO-level flags indicating data quality and filing health.

    Recent

    Whether EPFO data for this employee was recently updated.

    Name Unique

    Whether the employee's name appears uniquely in EPFO (no duplicates).

    Pf Filings Details

    Whether PF filing details are available for this employee.

    Employer Details

    Details of the most recent employer including setup date, ownership type, and monthly PF contribution history.

    Setup Date

    Date the employer establishment was set up/registered with EPFO.

    Ownership Type

    Ownership type of the establishment (e.g., Private, Government, Public Sector).

    Employer Name Match

    Whether the resolved employer name matches the expected employer name.

    PF Filing History

    Monthly PF contribution records filed by the employer. Each entry represents one wage month.

    Wage Month

    The wage month for this PF filing entry (YYYY-MM format).

    Total Amount

    Total PF amount contributed by the employer for this wage month.

    Employees Count

    Number of employees covered under this PF filing for the wage month.

    Simplified API Preview

    Employee Verification API Flow – Sample Request and Response

    Send simple inputs. Get rich, verified data in seconds.

    Verify employment history and employee identity by phone number via EPFO/UAN data.

    REQUEST
    Phone9876543210
    RESPONSE
    200 OK
    Universal Account Number (UAN)1001234567890
    Employee NameRajesh Kumar
    GenderMale
    Employee's DOB1994-08-29
    Is Aadhaar Verified?false
    Member IdMH/BOM/12345/000/0000001
    Establishment IdMHBAN0012345000
    Establishment NameAcme Pvt Ltd
    Joining Date2019-04-01
    Exit Date2023-06-30
    Leave ReasonResignation
    PAN NumberABCDE1234F
    Universal Account Number (UAN)1001234567890
    Member IdMH/BOM/12345/000/0000001
    Joining Date2019-04-01
    Exit Date2023-06-30
    Is Currently Employed?false
    Exit Date Markedtrue
    Employee Name Matchtrue
    Recenttrue
    Name Uniquetrue
    Pf Filings Detailstrue
    Establishment IdMHBAN0012345000
    Establishment NameAcme Pvt Ltd
    Setup Date2005-03-15
    Ownership TypePrivate
    Employer Name Matchtrue
    Wage Month2023-05
    Total Amount1800
    Employees Count120

    Key Features

    Everything you need to integrate and scale

    Employee Identity Verification

    Verify employee identity details digitally as part of onboarding.

    Hiring Risk Reduction

    Detect inconsistencies early to reduce impersonation and compliance risk.

    Automation Friendly

    Integrates seamlessly into HRMS, ATS, and onboarding platforms.

    High-Volume Support

    Designed to support large-scale hiring and verification needs.

    Who Should Use This API?

    Enterprises and large employers
    HR tech platforms
    Gig economy and staffing companies
    Organizations with compliance-driven hiring

    Primary Use Cases

    Pre-employment verification
    Contractor and gig worker onboarding
    Workforce compliance checks
    Enterprise HR verification workflows

    How to Integrate

    Get started in minutes with our simple integration process

    1. 1

      Sign Up

      Create an account on Connect App and get your sandbox credentials.

    2. 2

      Submit KYC

      Complete your KYC verification process by submitting the required documents.

    3. 3

      Integrate API

      Use our comprehensive documentation to integrate the APIs.

    4. 4

      Test in Sandbox

      Test your integration thoroughly in our sandbox environment.

    5. 5

      Go Live

      Start verifying employees in production.

    Frequently Asked Questions

    What can be verified?+

    Employee identity details including name, ID documents, and related information can be verified digitally.

    Does it integrate with HRMS?+

    Yes, the API integrates seamlessly into HRMS, ATS, and onboarding platforms.

    Can the API handle high volumes?+

    Yes. The API is designed to handle large-scale volumes reliably without performance degradation.

    How does API authentication work?+

    Every API call is secured with one-time-use tokens generated using asymmetric cryptography. After signing up, you will receive your developer-key and secret-key for both UAT and production environments, which you can use to generate tokens for authenticating your API requests.

    How are errors and failures reported?+

    Every response includes a status code and a human-readable message. Failed requests return specific error codes indicating the reason, so you can handle each case programmatically.

    Is there a sandbox environment for testing?+

    Yes. A full sandbox environment is available immediately on signup. You can test your integration end-to-end before going live — no commitment required.

    How is API usage billed?+

    Usage is billed per successful API call with no minimum commitment. Volume-based pricing tiers are available — contact our team for detailed rates.

    How do I get started?+

    Sign up on Connect App, submit the required documents, integrate the REST API using our sandbox environment, and go live.

    Get API Access

    Sign up now and start integrating in minutes. Our team will help you go live quickly.

    • Sandbox access in minutes
    • Dedicated integration support
    • Comprehensive documentation
    • Reliable, high-volume workflows

    Get Employee Verification API Access

    Get started in 10 minutes