Shop Establishment License Verification API

Endpoint Overview

POST /api/v1/se/

Description

The Shop Establishment License Verification API allows you to retrieve comprehensive details about a business's shop establishment license by providing the license number and state code. This API returns verified business information including registration details, owner information, employee statistics, and contact information from official government records.

Key Benefits

Instant verification of shop establishment licenses across multiple Indian states

Access to comprehensive business details including registration dates and validity

Retrieve accurate owner and management information for KYC and compliance purposes

Obtain workforce statistics for business analysis and verification

Use Cases

Financial Services

B2B Services

Compliance & Legal

Verify business legitimacy before approving business loans

Confirm business establishment details during merchant onboarding

Validate business credentials for credit underwriting

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	Bearer token for authentication (JWT format)
Content-Type	Yes	application/json

Request Body

Parameter	Type	Required	Description
id_number	String	Yes	Shop Establishment License Number
state_code	String	Yes	State Code (see supported states below)

Supported State Codes

State	Code
Haryana	HR
Rajasthan	RJ
Karnataka	KR
Delhi	DL
Jammu & Kashmir	JK
Telangana	TS
Uttarakhand	UK
Uttar Pradesh	UP
West Bengal	WB

Example Request

{
    "id_number": "91083640",
    "state_code": "RJ"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for all business details
data.client_id	String	Unique Client ID
data.se_number	String	Shop Establishment License Number
data.state_code	String	State Code
data.state_name	String	State Name
data.business_name	String	Business Name
data.address	String	Full Address of Business
data.user_mobile_number	String	Owner Mobile Number
data.registration_number	String	Shop Establishment Registration Number
data.registration_date	String	Shop Establishment Registration Date (YYYY-MM-DD)
data.category	String	Business Category
data.certificate_number	String	Business Certificate Number
data.document_link	String	Available Documents Link (if any)
data.date_of_commencement	String	Business Commencement Date (YYYY-MM-DD)
data.valid_upto	String	Certificate Expiry Date (YYYY-MM-DD)
data.acknowledgement_number	String	Acknowledgement Number
data.email_id	String	Owner Email ID
data.website_url	String	Business Website URL
data.name_of_occupier	String	Owner Name
data.father_name_of_occupier	String	Owner Father Name
data.manager_name	String	Business Manager Name
data.manager_father_name	String	Manager Father Name
data.male_workers	String	Total Male Workers in Business
data.female_workers	String	Total Female Workers in Business
data.young_workers	String	Total Young Workers in Business
data.total_workers	String	Total Workers in Business
data.family_members_working	String	Total Family Members Working in Business
data.confidential_employers_capacity	String	Confidential Employee Capacity
data.fax	String	Business FAX ID
status_code	Integer	HTTP Status Code
success	Boolean	Indicates if the request was successful
message	String	Response message
message_code	String	Response message code

Example Successful Response

{
    "data": {
        "client_id": "se_wHggjHpukklcZggqNuqs",
        "se_number": "20100129",
        "state_code": "DL",
        "state_name": "Delhi",
        "business_name": "Mohd Fruit Patri",
        "address": "0000 Gali Razia Begum Hauz Qazi Delhi Delhi",
        "user_mobile_number": "9650400000 23233843",
        "registration_number": "20100129",
        "registration_date": "2010-04-02",
        "category": "Fruit & Vegetables(Fresh, Processed & Dry)",
        "certificate_number": "20100129",
        "document_link": null,
        "date_of_commencement": "1970-12-30",
        "valid_upto": null,
        "acknowledgement_number": null,
        "email_id": "",
        "website_url": "",
        "name_of_occupier": "Mohd",
        "father_name_of_occupier": "Chhutan",
        "manager_name": "Mohd",
        "manager_father_name": "Chhutan",
        "male_workers": "1",
        "female_workers": "0",
        "young_workers": "0",
        "total_workers": "1",
        "family_members_working": "0",
        "confidential_employers_capacity": "0",
        "fax": ""
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid License Number

Invalid State Code

Authentication Error

{
    "status_code": 400,
    "success": false,
    "message": "Invalid license number provided",
    "message_code": "invalid_license"
}

The provided shop establishment license number is invalid or not found in the system.

Integration Best Practices

Security Recommendations

Store API credentials securely and never expose them in client-side code

Implement proper error handling to avoid exposing sensitive information

Use HTTPS for all API communications to ensure data encryption in transit

Implement rate limiting on your end to prevent abuse of the API

User Experience Guidelines

Implement caching for frequently accessed license information to improve response times

Display a clear loading state while waiting for API responses

Format dates in a user-friendly manner (e.g., "April 2, 2010" instead of "2010-04-02")

Provide clear error messages to end-users when verification fails

Code Samples

cURL

Python

Node.js

Related APIs

PAN Verification API - Verify individual and business PAN card details

GST Verification API - Verify GST registration details of businesses

Business Registration API - Verify company registration details

Address Verification API - Verify business address details

Compliance and Legal Considerations

This API provides access to business registration data that may be subject to privacy regulations. Ensure you have a legitimate business purpose for accessing this information and maintain proper data handling practices in accordance with applicable laws. The data should be used only for verification purposes and not for marketing or other unauthorized uses without proper consent.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/se/' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "id_number": "91083640", "state_code": "RJ" }'

{ "data": { "client_id": "se_wHggjHpukklcZggqNuqs", "se_number": "20100129", "state_code": "DL", "state_name": "Delhi", "business_name": "Mohd Fruit Patri", "address": "0000 Gali Razia Begum Hauz Qazi Delhi Delhi", "user_mobile_number": "9650400000 23233843", "registration_number": "20100129", "registration_date": "2010-04-02", "category": "Fruit & Vegetables(Fresh, Processed & Dry)", "certificate_number": "20100129", "document_link": null, "date_of_commencement": "1970-12-30", "valid_upto": null, "acknowledgement_number": null, "email_id": "", "website_url": "", "name_of_occupier": "Mohd", "father_name_of_occupier": "Chhutan", "manager_name": "Mohd", "manager_father_name": "Chhutan", "male_workers": "1", "female_workers": "0", "young_workers": "0", "total_workers": "1", "family_members_working": "0", "confidential_employers_capacity": "0", "fax": "" }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Get SE Details

Shop Establishment License Verification API#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Supported State Codes#

Example Request#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses