EPFO Basic Establishment Number/Name Based Search

4 min

Introduction

This API provides an easy and efficient way to retrieve establishment details for organizations registered under the Employees' Provident Fund Organization (EPFO) in India. With the EPFOS API, patrons can perform basic establishment searches using the establishment ID as input.

Sample cURL

curl --request POST \
  --url http://signzy.tech/api/v2/patrons/..your-patron-id../epfos \
  --header 'Accept: */*' \
  --header 'Accept-Language: en-US,en;q=0.8' \
  --header 'Authorization: <Access-Token>' \
  --header 'content-type: application/json' \
  --data '{"task":"basicEstablishmentSearch","essentials":{"establishmentId":"...establishmentId..."}}'

Field	Description	Example
task	Specifies the type of task to be performed.	"basicEstablishmentSearch"
essentials	Object containing the necessary parameters for the task.	{"establishmentId":"123456"}
establishmentId	Unique identifier of the establishment registered under EPFOs.	"123456"

Sample Response

{
  "result": {
      "establishmentId": "...establishmentId...",
      "establishmentName": "...establishmentName...",
      "validityStatus": {
          "establishmentStatus": "...establishmentStatus...",
          "registrationStatusOnEcrPortal": "...registrationStatusOnEcrPortal...",
          "postCoverageStatus": "..postCoverageStatus.."
      },
      "establishmentStatus": {
          "exemptionStatus": "...exemptionStatus...",
          "workingStatus": "...workingStatus..",
          "coverageSection": "..coverageSection..",
          "actionableStatus": "...actionableStatus...",
          "dateOfCoverage": "...dateOfCoverage..."
      },
      "establishmentDetails": {
          "panStatus": "..panStatus...",
          "sectionApplicable": "...sectionApplicable...",
          "primaryBusinessActivity": "...primaryBusinessActivity..",
          "esicCode": "...esicCode...",
          "ownershipType": "...ownershipType...",
          "dateOfSetupOfEstablishment": "..dateOfSetupOfEstablishment..",
          "address": "...address...",
          "pincode": "...pincode...",
          "city": "...city...",
          "district": "...district...",
          "state": "...state...",
          "country": "...country...",
          "epfoOfficeName": "...epfoOfficeName...",
          "epfoOfficeAddress": "...epfoOfficeAddress...",
          "zone": "...zone...",
          "region": "...region...",
          "splitAddress": {
              "state": [
                  []
              ],
              "district": [],
              "city": [],
              "pincode": "...pincode...",
              "country": [
                  "IN",
                  "IND",
                  "INDIA"
              ],
              "addressLine": "...addressLine..."
          }
      }
  }
}

Key	Value Type	Description
establishmentId	String	The unique identifier of the establishment.
establishmentName	String	The name of the establishment.
validityStatus	Object	Contains information about the validity status of the establishment.
establishmentStatus	Object	Contains information about the status of the establishment.
establishmentDetails	Object	Contains various details of the establishment.
establishmentStatus/exemptionStatus	String	The exemption status of the establishment.
establishmentStatus/workingStatus	String	The working status of the establishment.
establishmentStatus/coverageSection	String	The coverage section of the establishment.
establishmentStatus/actionableStatus	String	The actionable status of the establishment.
establishmentStatus/dateOfCoverage	String	The date of coverage of the establishment.
establishmentDetails/panStatus	String	The PAN status of the establishment.
establishmentDetails/sectionApplicable	String	The section applicable to the establishment.
establishmentDetails/primaryBusinessActivity	String	The primary business activity of the establishment.
establishmentDetails/esicCode	String	The ESIC code of the establishment.
establishmentDetails/ownershipType	String	The ownership type of the establishment.
establishmentDetails/dateOfSetupOfEstablishment	String	The date of establishment setup.
establishmentDetails/address	String	The address of the establishment.
establishmentDetails/pincode	String	The pincode of the establishment.
establishmentDetails/city	String	The city of the establishment.
establishmentDetails/district	String	The district of the establishment.
establishmentDetails/state	String	The state of the establishment.
establishmentDetails/country	String	The country of the establishment.
establishmentDetails/epfoOfficeName	String	The name of the EPFO office.
establishmentDetails/epfoOfficeAddress	String	The address of the EPFO office.
establishmentDetails/zone	String	The zone of the establishment.
establishmentDetails/region	String	The region of the establishment.
establishmentDetails/splitAddress	Object	Contains the split address of the establishment.
establishmentDetails/splitAddress/state	Array	The state(s) of the establishment.
establishmentDetails/splitAddress/district	Array	The district(s) of the establishment.
establishmentDetails/splitAddress/city	Array	The city(s) of the establishment.
establishmentDetails/splitAddress/pincode	String	The pincode of the establishment.
establishmentDetails/splitAddress/country	Array	The country(s) of the establishment.
establishmentDetails/splitAddress/addressLine	String	The address line of the establishment.