Establishment Details

POST /api/v1/epfo/establishment-details

Description

This API retrieves comprehensive information about an EPFO-registered establishment using its unique establishment ID. The response includes validity status, establishment details, additional information, payment history, and director information. This endpoint provides a complete profile of an establishment's EPFO registration and compliance status.

Key Benefits

Verify the legitimacy and registration status of an establishment with EPFO
Access detailed establishment information including address, business activity, and ownership type
Review payment history and employee records to assess compliance
Obtain director details for enhanced due diligence

Use Cases

- Verify establishment credentials during corporate loan application processing - Assess compliance history for credit risk evaluation - Validate establishment details for KYC/KYB processes - Verify employer EPFO registration status before accepting job offers - Validate establishment details during payroll service provider onboarding - Confirm compliance history for potential business partners - Conduct due diligence on potential business partners or vendors - Verify establishment details during corporate client onboarding - Validate director information for corporate governance checks

Technical Implementation

All API requests require authentication using a JWT Bearer token. Authentication follows these steps:

Obtain API Credentials: Register with Surepass to receive your API key.
Generate JWT Token: Use your API key to generate a JWT token.
Include in Requests: Add the token to the Authorization header as Bearer TOKEN.

Different authentication tokens are used for sandbox and production environments:

Sandbox: https://sandbox.surepass.io
Production: https://kyc-api.surepass.io

### Request Headers

Header	Required	Description
Authorization	Yes	Bearer token for authentication. Format: `Bearer <your_jwt_token>`
Content-Type	Yes	Must be set to `application/json`

Request Body

Parameter	Type	Required	Description
establishment_id	String	Yes	The unique EPFO establishment ID to query (e.g., "DLCPM0001014111")

Example Request

{
    "establishment_id": "DLCPM0001014111"
}

### Response Parameters

Parameter	Type	Description
data	Object	Contains the response data
data.client_id	String	Unique client ID for the request
data.establishment_id	String	The queried establishment ID
data.details	Object	Contains detailed information about the establishment
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the request was successful
message	String	Response message
message_code	String	Code indicating the response status

Details Object Structure

Parameter	Type	Description
validity_status	Object	Information about the establishment's registration status
establishment_details	Object	Comprehensive details about the establishment
additional_information	Object	Supplementary information including CIN, ESIC, LIN codes
payment_details	Array	History of EPFO payments with employee information
director_details	Array	Information about the establishment's directors

Validity Status Object

Parameter	Type	Description
establishment_code	String	Unique establishment code
establishment_name	String	Name of the establishment
establishment_status	String	Status of the establishment code allotment
registration_status	String	Registration status on the ECR portal
post_coverage	String	Additional information on post-coverage

Establishment Details Object

Parameter	Type	Description
establishment_name	String	Name of the establishment
establishment_code	String	Unique establishment code
pan_status	String	Status of PAN verification
section_applicable	String	Applicable section details for the establishment
primary_business_activity	String	Primary business activity of the establishment
esic_code	String	ESIC code, if applicable
ownership_type	String	Type of ownership of the establishment
date_of_setup	String	Date when the establishment was set up (YYYY-MM-DD)
address	String	Address of the establishment
pincode	String	Pincode of the establishment's location
city	String	City where the establishment is located
district	String	District of the establishment
state	String	State of the establishment
country	String	Country of the establishment
epfo_office_name	String	Name of the EPFO office
epfo_office_address	String	Address of the EPFO office
zone	String	Zone under which the establishment falls
region	String	Region under which the establishment falls

Additional Information Object

Parameter	Type	Description
establishment_id	String	Unique identifier for the establishment
cin_code	String	Corporate Identification Number (CIN)
esic_code	String	ESIC code
lin_code	String	LIN code
startup_order_number	String	Startup order number
startup_order_date	String	Date of startup order issuance (YYYY-MM-DD)
msme_order_number	String	MSME order number
msme_order_date	String	Date of MSME order issuance (YYYY-MM-DD)
pan_number	String	PAN Number

Payment Details Array (Each Object)

Parameter	Type	Description
trrn	String	Unique Transaction Reference Number
month	String	Month and Year of the record
number_of_employees	Integer	Total number of employees
amount	String	Total amount in Indian Rupees
ecr	String	Indicates if ECR is applicable
employees_list	Array	List of employee names

Director Details Array (Each Object)

Parameter	Type	Description
name	String	Full name of the director
designation	String	Job title or role
date_of_birth	String	Date of birth (YYYY-MM-DD)
father_name	String	Father's name
residential_address	String	Home address
position_date	String	Date of appointment to position (YYYY-MM-DD)

Example Successful Response

{
    "data": {
        "client_id": "establishment_details_QrElZIKaWjelauLiWpRd",
        "establishment_id": "DLCPM0001014111",
        "details": {
            "validity_status": {
                "establishment_code": "DLCPM0001014111",
                "establishment_name": "DELHI RACE CLUB",
                "establishment_status": "CODE NO ALLOTTED WAS BEFORE ONLINE REGISTRATION STARTED.",
                "registration_status": "PERMANENT LOGIN CREATED BY OWNER ON ECR PORTAL",
                "post_coverage": null
            },
            "establishment_details": {
                "establishment_name": "DELHI RACE CLUB",
                "establishment_code": "DLCPM0001014111",
                "pan_status": "VERIFIED",
                "section_applicable": "OTHER ESTABLISHMENTS IN WHICH EMPLOYING 20 OR MORE PERSONS AND NOTIFIED BY THE CENTRAL GOVT.",
                "primary_business_activity": "COMPANIES/SOCIETIES/ASSC/CLUBS/TROUPES FOR PERFORMANCES",
                "esic_code": null,
                "ownership_type": "REGISTERED SOCIETY",
                "date_of_setup": "1941-01-13",
                "address": "RACE COURCE MUSTAFA KEMAL ATATURK MARG",
                "pincode": "110001",
                "city": "NEW DELHI",
                "district": "CENTRAL",
                "state": "DELHI",
                "country": "India",
                "epfo_office_name": "DELHI (NORTH)",
                "epfo_office_address": "28, Community Centre, Wazirpur Industrial Area, ",
                "zone": "DELHI AND UTTARAKHAND",
                "region": "DL - DELHI (NORTH)"
            },
            "additional_information": {
                "establishment_id": null,
                "cin_code": null,
                "esic_code": null,
                "lin_code": null,
                "startup_order_number": null,
                "startup_order_date": "1800-01-01",
                "msme_order_number": null,
                "msme_order_date": "1800-01-01",
                "pan_number": null
            },
            "payment_details": [
                {
                    "trrn": "1012411000987",
                    "month": "OCT-24",
                    "number_of_employees": 46,
                    "amount": "1,68,172",
                    "ecr": "YES",
                    "employees_list": [
                        "ABHISHAKE",
                        "ATUL TIWARI",
                        "BABU SINGH",
                        "BALKISHAN KASHYAP",
                        "BHOLA PASWAN",
                        "BIDYA NAND MISHRA",
                        "BRAHAM PAL SINGH",
                        "DEVENDER KUMAR",
                        "DHARMENDER",
                        "GHAN SHYAM",
                        "ISHWAR DIN PATEL",
                        "JAGDISH",
                        "JAGDISH CHAND SHARMA",
                        "JAGDISH CHANDER",
                        "JATAN",
                        "JAY SINGH",
                        "KRISHNA SHARMA",
                        "KULDEEP SINGH",
                        "MEWALAL",
                        "MURARI LAL",
                        "NANDLAL",
                        "NARENDRA KUMAR MISHRA",
                        "NATHU",
                        "P RAJAGOPALAN",
                        "PARVEZ ALAM",
                        "PRAHLAD SINGH",
                        "RAJKUMAR",
                        "RAKESH KUMAR",
                        "RAM ASHISH",
                        "RAM HIND",
                        "RAM PAL",
                        "RAM UDGAR SAH",
                        "SAGAR KUMAR",
                        "SANJAY KUMAR",
                        "SATISH KUMAR",
                        "SHAHAB RAZA",
                        "SHANKAR LAL",
                        "SHIV KUMAR",
                        "SITHU LAL",
                        "SUBASH CHANDRA BEHERA",
                        "SURAJ RAWAT",
                        "SURENDER",
                        "SWATI TUSHAR PATIL",
                        "TULSA RAM",
                        "VIJAY PAL",
                        "VINOD KUMAR SHARMA"
                    ]
                },
                {
                    "trrn": "1012410000986",
                    "month": "SEP-24",
                    "number_of_employees": 47,
                    "amount": "1,68,167",
                    "ecr": "YES",
                    "employees_list": [
                        "ABHISHAKE",
                        "ATUL TIWARI",
                        "BABU SINGH",
                        "BALKISHAN KASHYAP",
                        "BHOLA PASWAN",
                        "BIDYA NAND MISHRA",
                        "BRAHAM PAL SINGH",
                        "DEVENDER KUMAR",
                        "DHARMENDER",
                        "GHAN SHYAM",
                        "ISHWAR DIN PATEL",
                        "JAGDISH",
                        "JAGDISH CHAND SHARMA",
                        "JAGDISH CHANDER",
                        "JATAN",
                        "JAY SINGH",
                        "KRISHNA SHARMA",
                        "KULDEEP SINGH",
                        "MEWALAL",
                        "MURARI LAL",
                        "NANDLAL",
                        "NARENDRA KUMAR MISHRA",
                        "NATHU",
                        "P RAJAGOPALAN",
                        "PARVEZ ALAM",
                        "PRAHLAD SINGH",
                        "RAJKUMAR",
                        "RAKESH KUMAR",
                        "RAM ASHISH",
                        "RAM HIND",
                        "RAM PAL",
                        "RAM UDGAR SAH",
                        "SAGAR KUMAR",
                        "SANJAY KUMAR",
                        "SARIKA",
                        "SATISH KUMAR",
                        "SHAHAB RAZA",
                        "SHANKAR LAL",
                        "SHIV KUMAR",
                        "SITHU LAL",
                        "SUBASH CHANDRA BEHERA",
                        "SURAJ RAWAT",
                        "SURENDER",
                        "SWATI TUSHAR PATIL",
                        "TULSA RAM",
                        "VIJAY PAL",
                        "VINOD KUMAR SHARMA"
                    ]
                }
            ],
            "director_details": [
                {
                    "name": "MANINDER SINGH NARULA",
                    "designation": "DIRECTOR",
                    "date_of_birth": "1955-09-09",
                    "father_name": "RANBIR SINGH NARULA",
                    "residential_address": "83/42, PUNJABI BAGH WEST, NEW DELHI-110026",
                    "position_date": "2020-08-24"
                },
                {
                    "name": "SHIV KUMAR GROVER",
                    "designation": "DIRECTOR",
                    "date_of_birth": "1959-01-01",
                    "father_name": "MADAN LAL GROVER",
                    "residential_address": "8, FIRST FLOOR, HEMKUNT COLONY,OPP NEHRU PLACE, GREATER KAILASH, NEW DELHI-110048",
                    "position_date": "2020-07-29"
                }
            ]
        }
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

```json { "status_code": 400, "success": false, "message": "Invalid establishment ID format", "message_code": "invalid_establishment_id" } ``` The establishment ID provided is not in the correct

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/epfo/establishment-details' \ --header 'Content-Type: application/json' \ --data-raw '{ "establishment_id": "DLCPM0001014111" }'

{ "data": { "client_id": "establishment_details_QrElZIKaWjelauLiWpRd", "establishment_id": "DLCPM0001014111", "details": { "validity_status": { "establishment_code": "DLCPM0001014111", "establishment_name": "DELHI RACE CLUB", "establishment_status": "CODE NO ALLOTTED WAS BEFORE ONLINE REGISTRATION STARTED.", "registration_status": "PERMANENT LOGIN CREATED BY OWNER ON ECR PORTAL", "post_coverage": null }, "establishment_details": { "establishment_name": "DELHI RACE CLUB", "establishment_code": "DLCPM0001014111", "pan_status": "VERIFIED", "section_applicable": "OTHER ESTABLISHMENTS IN WHICH EMPLOYING 20 OR MORE PERSONS AND NOTIFIED BY THE CENTRAL GOVT.", "primary_business_activity": "COMPANIES/SOCIETIES/ASSC/CLUBS/TROUPES FOR PERFORMANCES", "esic_code": null, "ownership_type": "REGISTERED SOCIETY", "date_of_setup": "1941-01-13", "address": "RACE COURCE MUSTAFA KEMAL ATATURK MARG", "pincode": "110001", "city": "NEW DELHI", "district": "CENTRAL", "state": "DELHI", "country": "India", "epfo_office_name": "DELHI (NORTH)", "epfo_office_address": "28, Community Centre, Wazirpur Industrial Area, ", "zone": "DELHI AND UTTARAKHAND", "region": "DL - DELHI (NORTH)" }, "additional_information": { "establishment_id": null, "cin_code": null, "esic_code": null, "lin_code": null, "startup_order_number": null, "startup_order_date": "1800-01-01", "msme_order_number": null, "msme_order_date": "1800-01-01", "pan_number": null }, "payment_details": [ { "trrn": "1012411000987", "month": "OCT-24", "number_of_employees": 46, "amount": "1,68,172", "ecr": "YES", "employees_list": [ "ABHISHAKE", "ATUL TIWARI", "BABU SINGH", "BALKISHAN KASHYAP", "BHOLA PASWAN", "BIDYA NAND MISHRA", "BRAHAM PAL SINGH", "DEVENDER KUMAR", "DHARMENDER", "GHAN SHYAM", "ISHWAR DIN PATEL", "JAGDISH", "JAGDISH CHAND SHARMA", "JAGDISH CHANDER", "JATAN", "JAY SINGH", "KRISHNA SHARMA", "KULDEEP SINGH", "MEWALAL", "MURARI LAL", "NANDLAL", "NARENDRA KUMAR MISHRA", "NATHU", "P RAJAGOPALAN", "PARVEZ ALAM", "PRAHLAD SINGH", "RAJKUMAR", "RAKESH KUMAR", "RAM ASHISH", "RAM HIND", "RAM PAL", "RAM UDGAR SAH", "SAGAR KUMAR", "SANJAY KUMAR", "SATISH KUMAR", "SHAHAB RAZA", "SHANKAR LAL", "SHIV KUMAR", "SITHU LAL", "SUBASH CHANDRA BEHERA", "SURAJ RAWAT", "SURENDER", "SWATI TUSHAR PATIL", "TULSA RAM", "VIJAY PAL", "VINOD KUMAR SHARMA" ] }, { "trrn": "1012410000986", "month": "SEP-24", "number_of_employees": 47, "amount": "1,68,167", "ecr": "YES", "employees_list": [ "ABHISHAKE", "ATUL TIWARI", "BABU SINGH", "BALKISHAN KASHYAP", "BHOLA PASWAN", "BIDYA NAND MISHRA", "BRAHAM PAL SINGH", "DEVENDER KUMAR", "DHARMENDER", "GHAN SHYAM", "ISHWAR DIN PATEL", "JAGDISH", "JAGDISH CHAND SHARMA", "JAGDISH CHANDER", "JATAN", "JAY SINGH", "KRISHNA SHARMA", "KULDEEP SINGH", "MEWALAL", "MURARI LAL", "NANDLAL", "NARENDRA KUMAR MISHRA", "NATHU", "P RAJAGOPALAN", "PARVEZ ALAM", "PRAHLAD SINGH", "RAJKUMAR", "RAKESH KUMAR", "RAM ASHISH", "RAM HIND", "RAM PAL", "RAM UDGAR SAH", "SAGAR KUMAR", "SANJAY KUMAR", "SARIKA", "SATISH KUMAR", "SHAHAB RAZA", "SHANKAR LAL", "SHIV KUMAR", "SITHU LAL", "SUBASH CHANDRA BEHERA", "SURAJ RAWAT", "SURENDER", "SWATI TUSHAR PATIL", "TULSA RAM", "VIJAY PAL", "VINOD KUMAR SHARMA" ] } ], "director_details": [ { "name": "MANINDER SINGH NARULA", "designation": "DIRECTOR", "date_of_birth": "1955-09-09", "father_name": "RANBIR SINGH NARULA", "residential_address": "83/42, PUNJABI BAGH WEST, NEW DELHI-110026", "position_date": "2020-08-24" }, { "name": "SHIV KUMAR GROVER", "designation": "DIRECTOR", "date_of_birth": "1959-01-01", "father_name": "MADAN LAL GROVER", "residential_address": "8, FIRST FLOOR, HEMKUNT COLONY,OPP NEHRU PLACE, GREATER KAILASH, NEW DELHI-110048", "position_date": "2020-07-29" } ] } }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************