Mobile To MSME

Endpoint Overview

POST /api/v1/corporate/mobile-to-msme

Description

This API endpoint allows you to retrieve MSME (Micro, Small, and Medium Enterprises) registration details associated with a given mobile number. The endpoint returns all MSME registrations linked to the provided mobile number, including unique MSME registration numbers and enterprise names.

Key Benefits

Quickly verify if a mobile number is associated with any registered MSME businesses

Retrieve multiple MSME registrations linked to a single mobile number

Access official enterprise names as registered with MSME authorities

Streamline KYC processes for business customers

Use Cases

Financial Services

B2B Services

Government & Compliance

Verify business identity during loan application processes

Validate MSME status for offering specialized financial products

Streamline business account opening procedures

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
mobile_number	String	Yes	The mobile number to query for associated MSME registrations

Example Request

{
    "mobile_number": "9560943155"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the response data
data.client_id	String	Unique identifier for the request
data.mobile_number	String	The mobile number that was queried
data.details	Array	List of MSME registrations associated with the mobile number
data.details[].msme_number	String	MSME registration number
data.details[].enterprise_name	String	Registered name of the enterprise
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the request was successful
message	String or null	Additional message (if any)
message_code	String	Code indicating the status of the request

Example Successful Response

{
    "data": {
        "client_id": "mobile_to_msme_bxfRtxlpyxEbqnruJGrW",
        "mobile_number": "9560943155",
        "details": [
            {
                "msme_number": "UDYAM-DL-04-123456",
                "enterprise_name": "M/S XYZ CH LLP"
            },
            {
                "msme_number": "UDYAM-DL-04-123456",
                "enterprise_name": "M/S XYZ"
            }
        ]
    },
    "status_code": 200,
    "success": true,
    "message": null,
    "message_code": "success"
}

Possible Error Responses

Invalid Mobile Number

No MSME Found

Authentication Error

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

The mobile number provided is not in a valid format. Ensure it is a 10-digit number without any prefixes.

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

Rotate JWT tokens periodically and implement token expiration

User Experience Guidelines

Implement proper validation for mobile number format before making API calls

Display a user-friendly message when no MSME registrations are found

Consider caching results for frequently queried mobile numbers to improve performance

Provide clear feedback to users when the API is processing or encounters errors

Code Samples

cURL

Python

Node.js

Related APIs

MSME Verification API: Verify MSME registration details using MSME number

Business KYC API: Comprehensive KYC verification for business entities

PAN to MSME API: Retrieve MSME details associated with a PAN number

Compliance and Legal Considerations

The data returned by this API contains business registration information that may be subject to privacy regulations. Ensure you have proper consent before storing or processing this data. The use of this API should comply with relevant data protection laws and regulations in your jurisdiction.

{ "data": { "client_id": "mobile_to_msme_bxfRtxlpyxEbqnruJGrW", "mobile_number": "9560943155", "details": [ { "msme_number": "UDYAM-DL-04-123456", "enterprise_name": "M/S XYZ CH LLP" }, { "msme_number": "UDYAM-DL-04-123456", "enterprise_name": "M/S XYZ" } ] }, "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 ********************

Mobile To MSME

Mobile To MSME#

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

Mobile To MSME

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples