Detailed Search by Establishment ID
The API returns detailed data about the establishment like establishmentName, validityStatus, establishmentStatus, pfPaymentDetails, etc.
You are required to pass the access token recieved from the login call, as authorization header in the EPFO Detailed Establishment Number Based Search request along with establishmentId.
You will need to login before sending firm number request.
PARAMETER NAME | DESCRIPTION |
Authorization | Access Token for authentication and authorization |
Content-Type | Specifies the format of the data sent in the request body |
task | The type of task to be performed. |
essentials | Contains the essential input data like establishmentId and employeeListMonths. |
establishmentId | ID of the Establishment. |
employeeListMonths | List of months for which information is required Format: MONTH/YEAR (MM/YYYY) Note: Value can only be upto last 1 year |
PARAMETER NAME | DESCRIPTION |
establishmentId | Unique id of the establishment. |
establishmentName | Name of the establishment. |
validityStatus | Contains details like establishmentStatus, registrationStatusOnEcrPortal, postCoverageStatus. |
establishmentStatus | status of the establishment |
registrationStatusOnEcrPortal | status of registration on ECR portal |
postCoverageStatus | status post coverage |
exemptionStatus | exemptionStatus |
workingStatus | workingStatus |
coverageSection | coverageSection |
actionableStatus | actionableStatus |
dateOfCoverage | dateOfCoverage |
panStatus | panStatus |
sectionApplicable | section to which it is applicable |
primaryBusinessActivity | primary business activity of employee |
esicCode | esicCode |
ownershipType | type of ownership |
dateOfSetupOfEstablishment | dateOfSetupOfEstablishment |
address | address |
pincode | pincode |
city | city |
district | district |
state | state |
country | country |
epfoOfficeName | name of EPFO office |
epfoOfficeAddress | address of EPFO office |
zone | zone |
region | region |
splitAddress | splitAddress |
state | state |
district | district |
city | city |
pincode | pincode |
country | country |
addressLine | addressLine |
pfPaymentDetails | pfPaymentDetails |
transactionId | ID of the transaction |
dateOfCredit | dateOfCredit |
timeOfCredit | timeOfCredit |
amount | amount |
wageMonth | wageMonth |
noOfEmployees | number of employees |
employeeNames | array containing list of employees |
CODE | MESSAGE |
200 | OK |
404 | Establishment not found |
400 | Establishment not found |
Getting help
Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.
You can reach out to us at [email protected].