Send OTP for Udyam Registration Verification

Endpoint Overview

POST /api/v1/udyam-otp/send-otp

Description

This API endpoint initiates the OTP verification process for Udyam Registration by sending a one-time password to the registered mobile number associated with the provided Udyam Aadhaar Registration Number. This verification step is essential for authenticating the identity of the business entity registered under the Udyam Registration system.

Key Benefits

Secure verification of Udyam registered businesses through OTP authentication

Seamless integration with India's MSME verification ecosystem

Reduces fraud by confirming the authenticity of Udyam registration details

Enables automated verification workflows for financial institutions and service providers

Use Cases

Financial Services

Government Services

B2B Services

Verify MSME status before processing business loan applications

Authenticate Udyam registration details during account opening procedures

Validate business credentials for credit assessment processes

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
registration_number	String	Yes	Udyam Aadhaar Registration Number of the business entity (e.g., "UDYAM-DL-04-000000")
mobile_number	String	Yes	Registered mobile number associated with the Udyam registration

Example Request

{
    "registration_number": "UDYAM-DL-04-000000",
    "mobile_number": "123456789"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the response data
data.client_id	String	Unique client ID used for subsequent API calls in the verification flow
status_code	Integer	HTTP status code indicating the result of the request
success	Boolean	Indicates whether the request was successful
message	String	Human-readable message describing the result
message_code	String	Machine-readable code for the message

Example Successful Response

{
    "data": {
        "client_id": "udyam_otp_obwSTJuBzqugyJHOjZyF"
    },
    "status_code": 200,
    "success": true,
    "message": "success",
    "message_code": "success"
}

Possible Error Responses

Invalid Registration Number

Invalid Mobile Number

Registration Not Found

{
    "data": {},
    "status_code": 400,
    "success": false,
    "message": "Invalid Udyam registration number format",
    "message_code": "invalid_registration_number"
}

The provided Udyam registration number does not match the expected format.

Integration Best Practices

Security Recommendations

Store the client_id securely as it will be needed for subsequent verification steps

Implement proper error handling to manage failed OTP delivery scenarios

Use HTTPS for all API communications to ensure data security

Rotate JWT tokens regularly and never hardcode them in client-side applications

User Experience Guidelines

Inform users that they will receive an OTP on their registered mobile number

Provide clear instructions on where to enter the OTP in your application

Implement a resend OTP option with appropriate rate limiting

Display meaningful error messages to help users troubleshoot verification issues

Code Samples

cURL

Python

Node.js

Related APIs

Verify Udyam OTP: Used to verify the OTP sent to the registered mobile number

Udyam Registration Details: Retrieves detailed information about a Udyam registration

Udyam Certificate Download: Allows downloading of the Udyam registration certificate

Compliance and Legal Considerations

This API facilitates verification of Udyam Registration details issued by the Ministry of Micro, Small and Medium Enterprises (MSME), Government of India. Ensure you have proper authorization to access and verify this information. The data should be used in compliance with applicable data protection regulations and the terms of service provided by Surepass.

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/udyam-otp/send-otp' \ --header 'Content-Type: application/json' \ --data-raw '{ "registration_number": "UDYAM-DL-04-000000", "mobile_number": "123456789" }'

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Send OTP

Send OTP for Udyam Registration Verification#

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