> For the complete documentation index, see [llms.txt](https://docs.tutelar.io/tutelar-api-document/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tutelar.io/tutelar-api-document/business-profile/epfo-basic-establishment.md).

# 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

<mark style="color:green;">`POST`</mark> `https://secctrl.tutelar.io/api/v1/services/business_profile/epfo_basic_establishment`

#### Sample Request Body

<table><thead><tr><th width="167">Body</th><th width="148">Type</th><th width="123.4296875">Mandatory</th><th width="307.59765625">Description</th></tr></thead><tbody><tr><td>establishmentId</td><td>string</td><td>Yes</td><td>Company's EPFO Establishment ID</td></tr><tr><td>months</td><td>string</td><td>Yes</td><td>Number of months to look back starting from current date to get monthly summary of transactions.</td></tr></tbody></table>

#### Sample Post Parameters

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

{% tabs %}
{% tab title="200: Success Response" %}

```json
{
    "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"
}
```

{% endtab %}

{% tab title="200 : In progress" %}

```json
{
    "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"
}
```

{% endtab %}

{% tab title="400: Validation Error Response" %}

```json
{
    "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"
    }
}

```

{% endtab %}

{% tab title="200: Failure Response" %}

```json
{
    "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"
}
```

{% endtab %}
{% endtabs %}

## Get details

<mark style="color:blue;">`GET`</mark> `https://secctrl.tutelar.io/api/v1/services/business_profile/epfo_basic_establishment`

### Query parameters description is given below,

<table><thead><tr><th width="197">Query Parameter </th><th width="139">Type</th><th>Is  Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>reference_id </td><td>String </td><td>Yes </td><td>Document reference id</td></tr></tbody></table>

{% tabs %}
{% tab title="200: Success Response" %}

```json
{
    "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"
}
```

{% endtab %}

{% tab title="200: Inprogress Response" %}

```json
{
    "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"
}
```

{% endtab %}

{% tab title="200: Failure Response" %}

```json
{
    "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"
}
```

{% endtab %}
{% endtabs %}