> ## 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 Search API

> Find an Indian establishment in the EPFO register by name. Returns every match the register gives (up to 100 per name) with the establishment id, registered name, address and EPFO office: the lookup step before pulling a full record by id.

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

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

One or more establishment or company names.

## Request

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

**names** `string[]` *required*

One or more establishment or company names to search the EPFO register for, e.g. INFOSYS. Each name returns every establishment the register matches, one row each, up to 100, which is the register's own ceiling.

**maxResults** `integer`

Stop after this many matches have been returned. Each match costs a row, so this caps the bill as well as the output. But the register's order is regional, not best-match, so a low cap is an arbitrary slice rather than the closest names. 0 or omitted means every match found, which on a broad name is up to 100 per name.

Max `100`.

## Example

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

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

r = requests.post(
    "https://api.mindcase.co/v1/data/pf-info/listing/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "names": [
        "INFOSYS"
    ]
}},
)
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/listing/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "names": [
    "INFOSYS"
  ]
} }),
});
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 |
| `address` | Address | text |
| `office` | Office Name | text |
| `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/listing",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "establishmentName": "U C INFOSYSTEMS PRIVATE LIMITED",
      "scrapedAt": "2026-09-28T07:51:18.539492+00:00",
      "office": "DELHI (NORTH)",
      "address": "201, NO.1 COMMUNITY CENTRENARAINA, PHASE-I",
      "establishmentId": "DLCPM0035522000"
    }
  ]
}
```

## Related APIs

For the full EPFO record of a match use [`pf-info/establishment`](https://docs.mindcase.co/apis/pf-info/establishment).


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