Udyam Assist Verify API

Endpoint Overview

POST /api/v1/corporate/udyog-aadhaar/udyam-assist-verify

Description

The Udyam Assist Verify API enables businesses to verify MSME (Micro, Small & Medium Enterprises) registration details using the UDYAM number. This comprehensive verification service validates business identity and returns detailed information including entrepreneur details, business information, address records, and associated bank accounts. The API is essential for MSME-related business verification, enabling lenders, partners, and service providers to authenticate small business credentials quickly and securely.

This endpoint integrates with the official Udyam registration database to provide real-time verification of MSME certificates, ensuring authenticity and reducing fraud risk in business transactions.

Key Benefits

Instant MSME Verification: Verify business registration status in real-time using official UDYAM database

Comprehensive Business Intelligence: Access entrepreneur details, business activities, and financial information

Fraud Prevention: Authenticate MSME certificates to prevent fraudulent business claims

Streamlined Onboarding: Accelerate customer verification processes for lending and partnership decisions

Use Cases

Financial Services

B2B Platforms

Government & Compliance

MSME Lending: Verify business credentials before approving loans or credit facilities

Account Opening: Validate MSME status for specialized banking products and services

Credit Assessment: Access business activity and turnover data for risk evaluation

Compliance Verification: Ensure adherence to MSME lending regulations and guidelines

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 API authentication (JWT format)
Content-Type	Yes	Must be set to `application/json`
Accept	No	Preferred response format (defaults to `application/json`)

Request Body

Parameter	Type	Required	Description
id_number	String	Yes	Valid UDYAM registration number in format `UDYAM-{state}-{category}-{year}-{serial}`

Example Request

{
  "id_number": "UDYAM-I-Cg-19-0000009"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for all verification data
data.client_id	String	Unique identifier for the verification request
data.id_number	String	Verified UDYAM number
data.input_id_number	String	Original input UDYAM number
data.entrepreneur_name	String	Name of the business owner/entrepreneur
data.gender	String	Gender of the entrepreneur
data.social_category	String	Social category (General/SC/ST/OBC)
data.organization_name	String	Registered business/organization name
data.organization_type	String	Type of organization (Proprietory/Partnership/Company)
data.nic_details	Array	National Industrial Classification codes
data.activity	String	Primary business activity description
data.major_activities	String	Major category of business activities
data.date_of_registration	String	UDYAM registration date (YYYY-MM-DD format)
data.dob	String	Date of birth of entrepreneur (YYYY-MM-DD format)
data.mobile	String	Registered mobile number
data.address	Array	Array of address objects with residential details
data.aadhar_reference_no	String	Masked Aadhaar reference number
data.customer_id	String	Unique customer identifier
data.formatted_file_number	String	Formatted file reference number
data.is_business_commercial	Boolean	Indicates if business is commercial
data.dms_file_id	String	Document management system file ID
data.bsr_code	String	Bank Statistical Return code
data.activity_description	String	Detailed activity description
data.aadhar_verified	Boolean	Aadhaar verification status
data.voter_verified	Boolean	Voter ID verification status
data.specially_abled	Boolean	Specially abled status
data.created_by	String	Record creation identifier
data.bank_customer_id	String	Bank customer identification
data.adv_status	String	Advance status code
data.occupation_details	Array	Detailed occupation and employment information
data.bank_details	Array	Associated bank account details
data.modified_date	String	Last modification date
status_code	Integer	HTTP status code
success	Boolean	API call success indicator
message	String	Response message (null on success)
message_code	String	Response message code

Example Successful Response

{
  "data": {
    "client_id": "udyam_assist_verify_zrfcYYcYowsJXgXMvNyN",
    "id_number": "UDYAM-I-Cg-19-0000009",
    "input_id_number": "UDYAM-I-Cg-19-0000009",
    "entrepreneur_name": "Anushka Kesharwani",
    "gender": "Female",
    "social_category": "General",
    "organization_name": "Anushka Kesharwani",
    "organization_type": "Proprietory",
    "nic_details": [
      {
        "nic_five_digit_code": "12101"
      }
    ],
    "activity": "Custom tailoring",
    "major_activities": "Manufacturing",
    "date_of_registration": "2024-05-02",
    "dob": "1973-03-03",
    "mobile": "7779090897",
    "address": [
      {
        "city": "Devkar Town Panchayat",
        "state": "CHHATTISGARH",
        "district": "BEMETARA",
        "pincode": "491234",
        "residential_address": "C/o: W/O Anushka Kesharwani\nHouse: -\nvtc: Devkar\nSubdist: Saja\nStreet: -\nState: Chhattisgarh\npo: Devkar\npc: 491234\ndist: Bemetara\nCountry: India, , "
      },
      {
        "city": "Devkar Town Panchayat",
        "state": "CHHATTISGARH",
        "district": "BEMETARA",
        "pincode": "491987",
        "residential_address": "C/o: W/O Sushil Kesharwani\nHouse: -\nvtc: Devkar\nSubdist: Saja\nStreet: -\nState: Chhattisgarh\npo: Devkar\npc: 491987\ndist: Bemetara\nCountry: India, , "
      }
    ],
    "aadhar_reference_no": "113342229999999999",
    "customer_id": "CW-AWC-31600000",
    "formatted_file_number": "CW-AWC-11111",
    "is_business_commercial": true,
    "dms_file_id": "14222",
    "bsr_code": "14111",
    "activity_description": "Custom tailoring",
    "aadhar_verified": false,
    "voter_verified": false,
    "specially_abled": false,
    "created_by": "9999",
    "bank_customer_id": "13838123",
    "adv_status": "1",
    "occupation_details": [
      {
        "major_activities": "Manufacturing",
        "no_of_employees": "1",
        "wdv_value": "0.0",
        "turnover_value": "0.0"
      }
    ],
    "bank_details": [
      {
        "account_number": "34471785123",
        "bank_name": "State Bank of India",
        "ifsc_code": "SBIN0014111"
      }
    ],
    "modified_date": "2024-01-01"
  },
  "status_code": 200,
  "success": true,
  "message": null,
  "message_code": "success"
}

Possible Error Responses

Invalid UDYAM Number

Invalid Udyam

Authentication Error

Server Error

{
  "data": null,
  "status_code": 400,
  "success": false,
  "message": "Invalid UDYAM number format",
  "message_code": "invalid_input"
}

Returned when the provided UDYAM number doesn't match the expected format or contains invalid characters.

Integration Best Practices

Security Recommendations

Token Management: Store JWT tokens securely and implement automatic refresh mechanisms

Data Encryption: Encrypt sensitive response data before storing in your systems

Access Controls: Implement role-based access to limit who can perform UDYAM verifications

Audit Logging: Maintain detailed logs of all verification requests for compliance purposes

Rate Limiting: Implement client-side rate limiting to avoid exceeding API quotas

User Experience Guidelines

Input Validation: Validate UDYAM number format client-side before API calls

Progress Indicators: Show loading states during verification process

Error Handling: Provide clear, user-friendly error messages for failed verifications

Data Presentation: Display verification results in an organized, easy-to-read format

Caching Strategy: Cache successful verifications appropriately to reduce API calls

Code Samples

cURL

Python

Node.js

Related APIs

PAN Verification API: Verify PAN card details for business owners and directors

GST Verification API: Validate GST registration and return filing status

Bank Account Verification API: Verify bank account details and account holder information

Company Search API: Search and verify company registration details from MCA database

Director Search API: Verify director details and associated company information

Compliance and Legal Considerations

Data Privacy: Ensure compliance with data protection regulations when handling personal information

MSME Act Compliance: Verify that your use case aligns with MSME Act guidelines and regulations

Record Retention: Maintain verification records as per regulatory requirements for audit purposes

Consent Management: Obtain proper consent from business owners before performing verification

Cross-border Usage: Be aware of international data transfer restrictions when using this API globally

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/corporate/udyog-aadhaar/udyam-assist-verify' \ --header 'Content-Type: application/json' \ --data-raw '{ "id_number": "UDYAM-I-Cg-19-0000009" }'

{ "data": { "client_id": "udyam_assist_verify_zrfcYYcYowsJXgXMvNyN", "id_number": "UDYAM-I-Cg-19-0000009", "input_id_number": "UDYAM-I-Cg-19-0000009", "entrepreneur_name": "Anushka Kesharwani", "gender": "Female", "social_category": "General", "organization_name": "Anushka Kesharwani", "organization_type": "Proprietory", "nic_details": [ { "nic_five_digit_code": "12101" } ], "activity": "Custom tailoring", "major_activities": "Manufacturing", "date_of_registration": "2024-05-02", "dob": "1973-03-03", "mobile": "7779090897", "address": [ { "city": "Devkar Town Panchayat", "state": "CHHATTISGARH", "district": "BEMETARA", "pincode": "491234", "residential_address": "C/o: W/O Anushka Kesharwani\nHouse: -\nvtc: Devkar\nSubdist: Saja\nStreet: -\nState: Chhattisgarh\npo: Devkar\npc: 491234\ndist: Bemetara\nCountry: India, , " }, { "city": "Devkar Town Panchayat", "state": "CHHATTISGARH", "district": "BEMETARA", "pincode": "491987", "residential_address": "C/o: W/O Sushil Kesharwani\nHouse: -\nvtc: Devkar\nSubdist: Saja\nStreet: -\nState: Chhattisgarh\npo: Devkar\npc: 491987\ndist: Bemetara\nCountry: India, , " } ], "aadhar_reference_no": "113342229999999999", "customer_id": "CW-AWC-31600000", "formatted_file_number": "CW-AWC-11111", "is_business_commercial": true, "dms_file_id": "14222", "bsr_code": "14111", "activity_description": "Custom tailoring", "aadhar_verified": false, "voter_verified": false, "specially_abled": false, "created_by": "9999", "bank_customer_id": "13838123", "adv_status": "1", "occupation_details": [ { "major_activities": "Manufacturing", "no_of_employees": "1", "wdv_value": "0.0", "turnover_value": "0.0" } ], "bank_details": [ { "account_number": "34471785123", "bank_name": "State Bank of India", "ifsc_code": "SBIN0014111" } ], "modified_date": "2024-01-01" }, "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 ********************

Udyam Assist Verify

Udyam Assist Verify API#

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