ESIC Details

Endpoint Overview

POST /api/v1/esic/esic-v2

Description

This API retrieves information from the Employees State Insurance Corporation (ESIC) database using an ESIC ID number. It returns verified details including the ESIC ID number and the registered name of the ESIC holder. This endpoint enables organizations to validate ESIC registration status and retrieve official identity information for employment verification, compliance checks, and identity validation purposes.

Key Benefits

Instant verification of ESIC registration status

Retrieval of official ESIC holder name for identity validation

Streamlined employee onboarding and compliance verification

Reduction in manual verification efforts and associated costs

Use Cases

HR & Recruitment

Financial Services

Compliance & Auditing

Verify employment history and ESIC registration during candidate screening

Automate employee onboarding verification processes

Validate contractor ESIC compliance before engagement

Technical Implementation

Authentication

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 Parameters

Request Headers

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

Request Body

Parameter	Type	Required	Description
id_number	String	Yes	ESIC ID number to be verified

Example Request

{
    "id_number": "123456789"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for the response data
data.client_id	String	Unique identifier for the verification request
data.id_number	String	ESIC ID number that was verified
data.name	String	Full name of the ESIC holder as registered
status_code	Integer	HTTP status code indicating the result of the request
success	Boolean	Indicates whether the request was successful
message	String or null	Additional information about the response (null if successful)
message_code	String	Code indicating the status of the response

Example Successful Response

{
    "data": {
        "client_id": "esic_v2_vwtiheIDwGmXmrtojWrv",
        "id_number": "123456789",
        "name": "DEEPAK KUMAR"
    },
    "status_code": 200,
    "success": true,
    "message": null,
    "message_code": "success"
}

Possible Error Responses

Invalid ID Number

ID Not Found

Authentication Error

{
    "status_code": 400,
    "success": false,
    "message": "Invalid ESIC ID number format",
    "message_code": "invalid_input"
}

The provided ESIC ID number is not in the correct format or contains invalid characters.

Integration Best Practices

Security Recommendations

Store API keys and tokens securely, never in client-side code

Implement proper error handling to avoid exposing sensitive information

Use HTTPS for all API communications

Implement rate limiting on your end to prevent abuse

Rotate JWT tokens periodically and avoid long-lived tokens

User Experience Guidelines

Implement client-side validation for ESIC ID format before making API calls

Display clear error messages to users when verification fails

Show loading indicators during API calls to indicate processing

Cache successful verification results (within compliance limits) to reduce redundant calls

Provide clear instructions for users to correct invalid inputs

Code Samples

cURL

Python

Node.js

Related APIs

PAN Verification API: Verify Permanent Account Number details

Aadhaar Verification API: Verify Aadhaar identity information

EPF Verification API: Verify Employee Provident Fund details

UAN Verification API: Verify Universal Account Number details

Compliance and Legal Considerations

ESIC data is sensitive personal information and must be handled in accordance with data protection regulations

Ensure you have appropriate consent from individuals before verifying their ESIC details

Store verification results securely and maintain proper access controls

Implement data retention policies that comply with local regulations

Usage of this API should comply with the terms and conditions of ESIC and Surepass

{ "data": { "client_id": "esic_v2_vwtiheIDwGmXmrtojWrv", "id_number": "123456789", "name": "DEEPAK KUMAR" }, "status_code": 200, "success": true, "message": null, "message_code": "success" }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

ESIC Details

ESIC Details#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

ESIC Details

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples