EPFO Basic Establishment

The EPFO Establishment API retrieves establishment details using the provided Establishment ID and generates a monthly summary of the establishment’s transactions for the specified number of months.

epfo_basic_establishment

POST https://secctrl.tutelar.io/api/v1/services/business_profile/epfo_basic_establishment

Sample Request Body

Body	Type	Mandatory	Description
establishmentId	string	Yes	Company's EPFO Establishment ID
months	string	Yes	Number of months to look back starting from current date to get monthly summary of transactions.

Sample Post Parameters

{
 "establishmentId": "TNMAS0084042000",
 "months": "2"
}

200: Success Response

{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "7432a1ae-dbe6-4f52-affb-a72412c9d5af",
    "status": "completed",
    "result": {
        "establishmentStatus": "Inactive",
        "establishmentInfo": {
            "address": "PETTUKOLA TOWERS 2ND FLOOR NO,190 A PETTUKOLA TOWERS 2ND FLOOR NO,190 A",
            "city": "CHENNAI",
            "country": "India",
            "dateOfSetupOfEstablishment": "",
            "district": "",
            "epfoOfficeAddress": "No. 37, Royapettah High Road, Opposite Swagat Hotel,",
            "epfoOfficeName": "CHENNAI",
            "esicCode": "",
            "establishmentCode": "TNMAS0084042000",
            "nameOfEstablishment": "ENTRUST EXIM",
            "ownershipType": "",
            "panStatus": "",
            "pinCode": "600010",
            "primaryBusinessActivity": "TRADING - COMMERCIAL ESTABLISHMENTS",
            "region": "TN - CHENNAI",
            "sectionApplicable": "OTHER ESTABLISHMENTS IN WHICH EMPLOYING 20 OR MORE PERSONS AND NOTIFIED BY THE CENTRAL GOVT.",
            "state": "TAMIL NADU",
            "zone": "TAMIL NADU AND KERALA"
        },
        "transactionsMonthlySummary": "No Payment details found for this Establishment id."
    },
    "requested_at": "2026-05-27T13:23:04.680Z",
    "completed_at": "2026-05-27T13:23:05.914Z"
}

200 : In progress

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "77a01069-2dfd-422f-8006-45389e2abf8a",
    "status": "in_progress",
    "requested_at": "2026-05-27T13:42:28.487Z"
}

400: Validation Error Response

{
    "success": false,
    "code": 400,
    "message": "Establishment Id should not be empty",
    "error": {
        "message": "Establishment Id should not be empty",
        "field": "establishmentId",
        "code": "BAD_REQUEST"
    }
}

{
    "success": false,
    "code": 400,
    "message": "Months should be between 1 and 4",
    "error": {
        "message": "Months should be between 1 and 4",
        "field": "months",
        "code": "BAD_REQUEST"
    }
}

200: Failure Response

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "84068ad7-9dd3-4b56-8d42-c77eead306f5",
    "status": "failed",
    "error": {
        "message": "No result found",
        "code": "ERROR"
    },
    "requested_at": "2026-05-27T13:44:16.463Z",
    "completed_at": "2026-05-27T13:44:19.847Z"
}

Get details

GET https://secctrl.tutelar.io/api/v1/services/business_profile/epfo_basic_establishment

Query parameters description is given below,

Query Parameter	Type	Is Mandatory	Description
reference_id	String	Yes	Document reference id

200: Success Response

{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "7432a1ae-dbe6-4f52-affb-a72412c9d5af",
    "status": "completed",
    "result": {
        "establishmentStatus": "Inactive",
        "establishmentInfo": {
            "address": "PETTUKOLA TOWERS 2ND FLOOR NO,190 A PETTUKOLA TOWERS 2ND FLOOR NO,190 A",
            "city": "CHENNAI",
            "country": "India",
            "dateOfSetupOfEstablishment": "",
            "district": "",
            "epfoOfficeAddress": "No. 37, Royapettah High Road, Opposite Swagat Hotel,",
            "epfoOfficeName": "CHENNAI",
            "esicCode": "",
            "establishmentCode": "TNMAS0084042000",
            "nameOfEstablishment": "ENTRUST EXIM",
            "ownershipType": "",
            "panStatus": "",
            "pinCode": "600010",
            "primaryBusinessActivity": "TRADING - COMMERCIAL ESTABLISHMENTS",
            "region": "TN - CHENNAI",
            "sectionApplicable": "OTHER ESTABLISHMENTS IN WHICH EMPLOYING 20 OR MORE PERSONS AND NOTIFIED BY THE CENTRAL GOVT.",
            "state": "TAMIL NADU",
            "zone": "TAMIL NADU AND KERALA"
        },
        "transactionsMonthlySummary": "No Payment details found for this Establishment id."
    },
    "requested_at": "2026-05-27T13:23:04.680Z",
    "completed_at": "2026-05-27T13:23:05.914Z"
}

200: Inprogress Response

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "77a01069-2dfd-422f-8006-45389e2abf8a",
    "status": "in_progress",
    "requested_at": "2026-05-27T13:42:28.487Z"
}

200: Failure Response

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "84068ad7-9dd3-4b56-8d42-c77eead306f5",
    "status": "failed",
    "error": {
        "message": "No result found",
        "code": "ERROR"
    },
    "requested_at": "2026-05-27T13:44:16.463Z",
    "completed_at": "2026-05-27T13:44:19.847Z"
}