API reference / Employment
EPFO establishment details
Establishment details with contribution summaries for the last 1 to 4 months.
POST
/v1/employment/establishment- Authentication
- Bearer token
- Scope
kyc:verify
Request body
| Field | Type | Required | Description |
|---|---|---|---|
establishment_id | string | Yes | The 15-character EPFO establishment ID, letters and digits. |
months | integer | Yes | How many recent months of contribution summary to return, 1 to 4. |
Sample code
Set your key in the GRAPPI_API_KEY environment variable. Sample values are placeholders.
curl -sS -X POST 'https://grappi.ai/v1/employment/establishment' \
-H "Authorization: Bearer $GRAPPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"establishment_id": "MHBAN0012345000",
"months": 2
}'Sample response
{
"request_id": "req_01HZY3K8M2",
"result": {
"establishment_status": "Active",
"establishment_info": {
"name_of_establishment": "EXAMPLE TECHNOLOGIES PRIVATE LIMITED",
"establishment_code": "MHBAN0012345000",
"ownership_type": "Private Limited Company",
"pan_status": "VERIFIED",
"date_of_setup_of_establishment": "01-JAN-2015",
"city": "Pune",
"state": "Maharashtra",
"pin_code": "411001",
"country": "India"
},
"transactions": {
"monthly_summary": [
{
"salary_month": "SEP-2026",
"total_amount": "3750000",
"total_employees": "120",
"is_delay": "No",
"delay_in_day": "0"
},
{
"salary_month": "AUG-2026",
"total_amount": "3700000",
"total_employees": "118",
"is_delay": "No",
"delay_in_day": "0"
}
]
}
}
}Response fields
| Field | Type | Description |
|---|---|---|
establishment_status | string | Whether the establishment is active. |
establishment_info | object | Registration details of the establishment. |
establishment_info.name_of_establishment | string | Name of the establishment. |
establishment_info.establishment_code | string | EPFO establishment code. |
establishment_info.esic_code | string | ESIC code, when registered. |
establishment_info.ownership_type | string | Legal form of the establishment. |
establishment_info.pan_status | string | Whether the PAN is verified. |
establishment_info.date_of_setup_of_establishment | string | Date the establishment was set up. |
establishment_info.primary_business_activity | string | Main business activity. |
establishment_info.section_applicable | string | The act section that applies. |
establishment_info.address | string | Address. |
establishment_info.city | string | City. |
establishment_info.district | string | District. |
establishment_info.state | string | State. |
establishment_info.pin_code | string | Pincode. |
establishment_info.country | string | Country. |
establishment_info.epfo_office_name | string | EPFO office handling the establishment. |
establishment_info.epfo_office_address | string | Address of that office. |
establishment_info.region | string | EPFO region. |
establishment_info.zone | string | EPFO zone. |
transactions | object | Recent contributions. |
transactions.monthly_summary | array | One entry per month requested. |
transactions.monthly_summary[].salary_month | string | Month the contribution covers. |
transactions.monthly_summary[].total_amount | string | Total contribution paid. |
transactions.monthly_summary[].total_employees | string | Number of employees covered. |
transactions.monthly_summary[].is_delay | string | Whether the payment was late. |
transactions.monthly_summary[].delay_in_day | string | Days late, when it was late. |
Errors
Every failure has the same shape. A call that fails on our side or at the data source is refunded to your wallet; a "no record found" answer is charged. See the error reference.