Employer Establishment Search

Workforce & Assets

Find a company's provident fund establishment record and confirm it is a real employer.

Search provident fund establishment records by company name or code to confirm a claimed employer exists, when it registered and where. The fast way to validate previous employers on a resume, especially small firms that leave few other traces.

Endpoint

POST https://app.emver.io/api/sandbox/v1/employer-search

Authorization: Bearer YOUR_API_KEY

Content-Type: application/json

Accept: application/json

Request parameters

Field	Type	Description
`employer_name_or_establishment_code` required	string	Employer name or establishment code
`city_or_state` optional	string	City or state

Example request

cURL

curl -X POST https://app.emver.io/api/sandbox/v1/employer-search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "employer_name_or_establishment_code": "string",
    "city_or_state": "string"
}'

import requests

response = requests.post(
    "https://app.emver.io/api/sandbox/v1/employer-search",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Accept": "application/json",
    },
    json={
        "employer_name_or_establishment_code": "string",
        "city_or_state": "string"
    },
    timeout=60,
)
response.raise_for_status()
data = response.json()

const response = await fetch("https://app.emver.io/api/sandbox/v1/employer-search", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
  },
  body: JSON.stringify({
      "employer_name_or_establishment_code": "string",
      "city_or_state": "string"
  }),
});

const data = await response.json();

$response = Http::withToken('YOUR_API_KEY')
    ->acceptJson()
    ->post('https://app.emver.io/api/sandbox/v1/employer-search', {
        "employer_name_or_establishment_code": "string",
        "city_or_state": "string"
    });

$data = $response->json();

Replace YOUR_API_KEY and the placeholder values. Use the switch above to see production URLs.

Response

Structure · 200

{
  "status": INTEGER,
  "message": STRING,
  "data": {
    "matching_establishments": STRING,
    "establishment_i_d_and_registration_date": STRING,
    "registered_address": STRING,
    "status": STRING
  }
}

Example · 200

{
  "status": 200,
  "message": "string",
  "data": {
    "matching_establishments": "string",
    "establishment_i_d_and_registration_date": "string",
    "registered_address": "string",
    "status": "string"
  }
}

Error · 4xx / 5xx

{
  "status": INTEGER,
  "message": STRING
}

See Errors & status codes for what each status means and which calls are billed.

About this API

Candidates sometimes list employers that never existed, or that existed under another name. The Employer Establishment Search API resolves a name or establishment code to the registered record, so emver verification starts from a confirmed entity rather than a phone number on the CV.

It also returns the establishment ID that links to the candidate's contribution history, tying the resume, the employer and the provident fund record together.

Typical uses

Employment verification. Validate each employer listed on a CV.
Vendor KYB. Confirm a supplier is a registered employer.
Staffing agencies. Screen client and candidate employers at scale.
Lending. Verify the employer declared on a loan application.

Questions

Does it show the company's employee count?: The response includes the establishment record and status; headcount figures are not part of the public record.
What if the company is exempt from provident fund?: Very small employers may not appear. emver then routes the check to manual employer verification.