> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# EPFO Establishment API

> The full public EPFO record for an Indian establishment: registration, coverage and exemption status, owners and directors, the statutory identifiers (CIN, LIN, ESIC), the EPFO office it belongs to, and the monthly PF remittance history with amount and employee count per wage month.

`POST /v1/data/pf-info/establishment/run`

**Pricing:** $0.05 per establishment ($50.00 per 1,000).

One or more full EPFO establishment ids.

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**est\_ids** `string[]` *required*

One or more FULL 15-character EPFO establishment ids, e.g. KDMAL1567124000: five office letters, a 7-digit establishment number and a 3-digit extension. Each id returns one row.

**maxResults** `integer`

Stop after this many have been looked up. Each one costs a row, so this caps the bill as well as the output. 0 or omitted means every id you sent.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/pf-info/establishment/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "est_ids": [
      "KDMAL2220876000"
    ]
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/pf-info/establishment/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "est_ids": [
        "KDMAL2220876000"
    ]
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/pf-info/establishment/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "est_ids": [
    "KDMAL2220876000"
  ]
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one establishment, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `establishmentId` | Establishment ID | text |
| `establishmentName` | Establishment Name | text |
| `nameAsPerPan` | Name (as per PAN) | text |
| `establishmentStatus` | Establishment Status | text |
| `workingStatus` | Working Status | text |
| `ecrRegistrationStatus` | ECR Registration Status | text |
| `postCoverageStatus` | Post Coverage Status | text |
| `exemptionStatus` | Exemption Status | text |
| `coverageSection` | Coverage Section | text |
| `actionableStatus` | Actionable Status | text |
| `dateOfCoverage` | Date of Coverage | date |
| `dateOfSetup` | Date of Setup | date |
| `primaryBusinessActivity` | Primary Business Activity | text |
| `sectionApplicable` | Section Applicable | text |
| `ownershipType` | Ownership Type | text |
| `panStatus` | PAN Status | text |
| `address` | Address | text |
| `pinCode` | Pin Code | text |
| `city` | City | text |
| `district` | District | text |
| `state` | State | text |
| `country` | Country | text |
| `epfoOfficeName` | EPFO Office Name | text |
| `epfoOfficeAddress` | EPFO Office Address | text |
| `cin` | CIN | text |
| `lin` | LIN | text |
| `esicCode` | ESIC Code | text |
| `startupOrderNo` | Startup Order No. | text |
| `msmeOrderNo` | MSME Order No. | text |
| `lastUpdatedOn` | Last Updated On | date |
| `epfoOffice` | Office (from search) | text |
| `directors` | Owners / Directors | object\_array |
| `paymentHistory` | PF Remittance History | object\_array |
| `scrapedAt` | Scraped At | date |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "pf-info/establishment",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "paymentHistory": [],
      "city": "Mumbai",
      "lin": "1632331122",
      "epfoOfficeName": "MALAD (KANDIVALI)",
      "startupOrderNo": "NA",
      "pinCode": "400093",
      "workingStatus": "LIVE ESTABLISHMENT",
      "actionableStatus": "ACTIONABLE ESTABLISHMENT",
      "sectionApplicable": "VOLUNTARY COVERAGE",
      "dateOfCoverage": "20-OCT-2020",
      "primaryBusinessActivity": "EDIBLE OIL - FAT",
      "msmeOrderNo": "NA",
      "country": "India",
      "postCoverageStatus": "--",
      "ecrRegistrationStatus": "PERMANENT LOGIN CREATED BY OWNER ON ECR PORTAL",
      "epfoOfficeAddress": "Bhavishya Nidhi Bhavan,Plot No.222, Sector No.3,Charkop Market,",
      "establishmentName": "GO JAIVIK INGREDIENTS (OPC) PRIVATE LIMITED",
      "scrapedAt": "2026-09-24T12:36:21.475695+00:00",
      "district": "MUMBAI CITY",
      "directors": [
        {
          "name": "Harshal Pradyuman Mehta",
          "designation": "Director",
          "dateOfBirth": "12-APR-1989",
          "fathersName": "Pradyuman Khimchand Mehta",
          "address": "1104-A, Vaastu Enclave,,Pump House, Jijamata road, Andheri E,Mumbai,India,Maharashtra,,400093,",
          "dateInPosition": "20-OCT-2020"
        }
      ],
      "state": "MAHARASHTRA",
      "epfoOffice": "MALAD (KANDIVALI)",
      "cin": "U15549MH2020OPC348275",
      "coverageSection": "0000001(4)",
      "establishmentStatus": "CODE NO ALLOTTED WAS AFTER ONLINE REGISTRATION STARTED."
    }
  ]
}
```

## Related APIs

To find the establishment id by name use [`pf-info/listing`](https://docs.mindcase.co/apis/pf-info/listing); for the MCA company record use [`mca/company`](https://docs.mindcase.co/apis/mca/company).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.