Skip to main content
VerifyAll logo
LiveInstant answerSandbox

EPFO Establishment Verification API

Send a PF establishment ID and see whether the employer is active, how many people it pays PF for and whether it pays on time.

Request API access Book a demo View API documentation

The documentation opens in the VerifyAll dashboard after sign-in, for accounts with approved API access. New to the API? Start with the developer guide.

Overview

What the EPFO Establishment Verification API does

The EPFO Establishment Verification API takes an employer’s PF establishment ID, a code of 5 letters and 10 digits, and answers with the establishment’s name, status, ownership type, the date it was set up and its address. It adds the establishment’s monthly PF payments for the most recent 1 to 4 months: for each wage month, the number of employees the payment covers, the amount paid and how many days after the due date it was paid.

months_paid_late counts the payments made late, so a rule such as “no late PF payment in the last four months” reads one number. The employee count on each payment shows how many people the employer actually pays PF for.

The UAN Verification and Mobile to EPFO APIs look at a person’s employment; this API looks at the employer. HR teams use it to confirm that a candidate’s employer is a real, active establishment, procurement teams to see that a contractor pays its workers’ PF, and lenders to judge whether a business borrower is operating and meeting its dues.

How it works

  1. 1

    Your server sends POST /universal/epfo-establishment-verification with the establishment_id and, optionally, months: how many recent months of payments you want, 1 to 4 (default 4).

  2. 2

    The ID is tidied first: spaces and / are removed, and 5 letters with 7 digits is read with 000 added. An ID that still does not fit, a months value outside 1 to 4 or an unknown field is refused with every problem listed, before anything is charged.

  3. 3

    The establishment is checked against live records and the answer comes back in the same call, usually within a few seconds, with payments newest first.

  4. 4

    The result is stored in your VerifyAll account with a checkResultId; read it again, find it by your client_ref or download the PDF report for the vendor or employer file.

Request and response

EPFO establishment verification API endpoints and fields

The main fields; the full reference with every field, error code and a cURL sample is in the dashboard docs.

Endpoints
EndpointWhat it does
POST/universal/epfo-establishment-verificationVerify a PF establishment and return its recent PF payments

Request fields

EPFO Establishment Verification API request fields
FieldWhat it is
establishment_idRequiredThe PF establishment code: 5 letters and 10 digits (for example MHBAN0012345000). 5 letters and 7 digits are read with 000 added.
monthsOptionalHow many recent months of PF payments to return, 1 to 4; 4 when left out.
client_refOptionalYour own reference, stored with the result (up to 100 characters).

What the answer returns

EPFO Establishment Verification API answer fields
FieldWhat it is
establishment_id / nameThe PF establishment code checked and the establishment’s name.
status / activeThe establishment’s status in lower case (for example active or closed), and true or false for whether it is active.
ownershipThe type of ownership, for example Private Limited Company or Proprietorship.
set_up_onWhen the establishment was set up, YYYY-MM-DD.
addressline, city, district, state and pin_code of the establishment.
months_requestedHow many recent months of payments were asked for.
payments[]One entry per month, newest first: wage_month (YYYY-MM where it can be read), employees covered, amount paid in rupees as a two-decimal string, and days_late (0 when paid on time).
months_paid_lateHow many of those payments were made after the due date.

Base URL https://api.verifyall.ai. Authenticate with the X-API-Key header (a va_sandbox_ or va_live_ key). Every answer carries data, status_code, success, message and message_code; checks add outcome, checkResultId, charged and charged_amount.

Key features

EPFO Establishment Verification API features and capabilities

  • Employer details in one call

    Name, status, ownership, set-up date and address, so you can tell a live employer from a closed or newly formed one.

  • Recent PF payments, month by month

    Up to four wage months, each with the employees covered and the amount paid.

  • Late payments counted for you

    days_late on each payment and months_paid_late across them let a compliance rule flag an employer that pays PF late.

  • IDs accepted as people type them

    Spaces and slashes are removed and the shorter 7-digit form is padded, so there is no clean-up before calling.

Use cases

Where businesses use the EPFO Establishment Verification API

  • Employer check in background verification

    Confirm that the employer on a candidate’s CV exists, is active and matches the name and city the candidate gave.

  • Contractor and manpower agency compliance

    See whether a contractor or staffing agency pays PF for its workers, and pays on time, before you award or renew a contract.

  • Business lending and supplier due diligence

    Check that a borrower or supplier is operating, how many people it pays PF for and whether its dues are paid late.

  • Salaried borrower’s employer

    Confirm that a salaried applicant’s employer is active and paying PF before you rely on the salary for a loan.

Industries

Coverage

Employers in India that have a PF establishment ID, with their details and PF payments for up to the 4 most recent months. A business without a PF establishment ID cannot be checked here.

Limitations to plan for

  • At most the 4 most recent months of payments are returned. The API does not give a longer payment history.
  • The employee count is the number of people a payment covers. Staff the employer does not pay PF for are not counted.
  • Details not on record come back as null, and wage_month is given as on record when it cannot be read as YYYY-MM.
  • An establishment ID with no record answers record_not_found. The lookup ran, so it is charged like any completed check.

Integration

How to integrate the EPFO Establishment Verification API

From a business account to your first live call.

  1. Step 1

    Create a business account on VerifyAll and get it approved, as for running checks in the dashboard.

  2. Step 2

    Request Developer API access under Developers in the dashboard: the APIs you need, your expected monthly volume and your use case. The VerifyAll team reviews it and shares the API Services Agreement.

  3. Step 3

    Once the agreement is signed and access is approved, create your Sandbox key and build against sample data. Sandbox calls are never charged.

  4. Step 4

    Create your Production key, recharge your wallet and switch the key in your code: the endpoint and fields stay the same.

Get started

Request access to the EPFO Establishment Verification API

Tell us what you want to verify. We reply within one business day with access steps, Sandbox details and your API pricing.

Tell us about your integration

Tell us what you want to verify and how many checks you expect. Our team replies within one business day with access steps, Sandbox details and your API pricing.

We use these details only to reply to your request. See our privacy policy.

  • Contact sales

    Questions on volumes, onboarding or the API agreement.

    Contact sales

  • View API documentation

    The full reference for EPFO Establishment Verification API (endpoints, fields, errors, cURL) opens in the dashboard once your access is approved.

    Open the docs (sign-in)

  • Create a business account

    API keys are issued to an approved business account. Sign up, then request access under Developers.

    Create account

Pricing

Production calls are charged per check from your prepaid VerifyAll wallet, at your account’s API price; GST is added separately when you recharge. Sandbox calls are never charged. Your API prices are shown in the dashboard once access is approved. How pricing works

Already have a business account? Sign in to request access

EPFO Establishment Verification API: frequently asked questions

Answers for teams planning an integration.

Still have questions? Our team is happy to help.

Contact Support

All employment verification APIsRun EPFO establishment verification in the dashboard, without codeBrowse the API Marketplace

Start with the EPFO Establishment Verification API

Request access, build against the Sandbox, then go live with your Production key.

Request API access