ESIC Advanced V2

Endpoint Overview

POST /api/v1/esic/esic-advanced-v2

Description

The ESIC Advanced V2 API retrieves comprehensive information about individuals registered with the Employees State Insurance Corporation (ESIC) in India. By providing an ESIC ID number, you can verify the identity of an individual and obtain their registered name and mobile number. This API is particularly useful for employment verification, HR processes, and compliance checks.

Key Benefits

Instant verification of ESIC registration status

Access to official ESIC holder details including name and mobile number

Streamlined employee onboarding and verification processes

Reduced manual verification effort and paperwork

Use Cases

HR & Recruitment

Financial Services

Business Compliance

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	The ESIC ID number to be verified

Example Request

{
    "id_number": "123456789"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the ESIC holder information
data.client_id	String	Unique identifier for the API request
data.id_number	String	The ESIC ID number that was provided in the request
data.name	String	Full name of the ESIC holder as registered
data.mobile_number	String	Registered mobile number of the ESIC holder
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates whether the API call was successful
message	String or null	Additional information about the response (null if successful)
message_code	String	Code indicating the status of the request

Example Successful Response

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

Possible Error Responses

Invalid ESIC ID

Authentication Error

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

This error occurs when the provided ESIC ID number is not in the correct format or doesn't exist.

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

Rotate JWT tokens periodically and implement token expiration

User Experience Guidelines

Implement proper validation for ESIC ID format before making API calls

Display clear error messages to users when verification fails

Add loading indicators during API calls to improve user experience

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

Code Samples

cURL

Python

Node.js

Related APIs

ESIC Basic Verification API: Provides basic verification of ESIC registration status

Employee Verification API: Comprehensive employment verification including multiple identity sources

Document OCR API: Extract information from ESIC cards and other identity documents

Compliance and Legal Considerations

The use of ESIC data is subject to Indian labor laws and data protection regulations

Ensure you have proper consent before verifying an individual's ESIC information

Store retrieved data securely and in compliance with data protection regulations

The API should only be used for legitimate business purposes such as employment verification and compliance

{ "data": { "client_id": "esic_advanced_v2_tEttMSzjXlmaMsFVkcnz", "id_number": "123456789", "name": "DEEPAK KUMAR", "mobile_number": "9191919191" }, "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 Advanced V2

ESIC Advanced V2#

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 Advanced V2

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples