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

FieldTypeRequiredDescription
establishment_idstringYesThe 15-character EPFO establishment ID, letters and digits.
monthsintegerYesHow 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

FieldTypeDescription
establishment_statusstringWhether the establishment is active.
establishment_infoobjectRegistration details of the establishment.
establishment_info.name_of_establishmentstringName of the establishment.
establishment_info.establishment_codestringEPFO establishment code.
establishment_info.esic_codestringESIC code, when registered.
establishment_info.ownership_typestringLegal form of the establishment.
establishment_info.pan_statusstringWhether the PAN is verified.
establishment_info.date_of_setup_of_establishmentstringDate the establishment was set up.
establishment_info.primary_business_activitystringMain business activity.
establishment_info.section_applicablestringThe act section that applies.
establishment_info.addressstringAddress.
establishment_info.citystringCity.
establishment_info.districtstringDistrict.
establishment_info.statestringState.
establishment_info.pin_codestringPincode.
establishment_info.countrystringCountry.
establishment_info.epfo_office_namestringEPFO office handling the establishment.
establishment_info.epfo_office_addressstringAddress of that office.
establishment_info.regionstringEPFO region.
establishment_info.zonestringEPFO zone.
transactionsobjectRecent contributions.
transactions.monthly_summaryarrayOne entry per month requested.
transactions.monthly_summary[].salary_monthstringMonth the contribution covers.
transactions.monthly_summary[].total_amountstringTotal contribution paid.
transactions.monthly_summary[].total_employeesstringNumber of employees covered.
transactions.monthly_summary[].is_delaystringWhether the payment was late.
transactions.monthly_summary[].delay_in_daystringDays 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.