Udyog Aadhaar Verification - Status

Endpoint Overview

POST /api/v1/corporate/udyog-aadhaar/status

Description

The Udyog Aadhaar Verification Status API retrieves the complete verification results for a previously initiated Udyog Aadhaar verification request. After initializing a verification request using the Initialize endpoint, use this API to fetch comprehensive business details, including enterprise classification, ownership information, plant locations, and NIC (National Industrial Classification) codes.

This endpoint provides rich, structured data about MSME enterprises registered under the Udyam scheme, enabling businesses to make informed decisions about partnerships, credit assessments, and compliance verification. The response includes historical enterprise type classifications, complete address details, contact information, and industry-specific activity codes. The API supports multiple verification statuses to accurately reflect the current state of the Udyog Aadhaar registration.

Key Benefits

Comprehensive Business Intelligence: Access detailed enterprise information including ownership structure, activity type, social category, and multi-year classification history

Real-time Status Tracking: Monitor verification progress with seven distinct status states (pending, success, invalid, failed, registration_cancelled, registration_pending, update_pending)

Certificate Access: Retrieve pre-signed URLs to official Udyog Aadhaar certificates for documentation and compliance purposes when verification is successful

Industry Classification: Get precise NIC codes at 2-digit, 4-digit, and 5-digit levels for accurate business categorization and sector analysis

Use Cases

Financial Services

Supply Chain Management

Government & Regulatory

Credit Risk Assessment: Analyze enterprise type progression over multiple years to assess business growth trajectory and stability for loan approvals

MSME Loan Programs: Verify current MSME classification (Micro/Small/Medium) to determine eligibility for government-backed lending schemes with preferential interest rates

KYC Compliance: Retrieve verified business owner details, contact information, and registration dates as part of comprehensive Know Your Customer processes

Collateral Verification: Cross-reference plant locations and business addresses to validate physical asset ownership during secured lending

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.app

Production: https://kyc-api.surepass.app

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token for API authentication. Format: `Bearer YOUR_JWT_TOKEN`
Content-Type	Yes	Must be set to `application/json`

Request Body

Parameter	Type	Required	Description
client_id	string	Yes	The unique identifier returned from the Initialize endpoint. This ID tracks the specific verification request and is required to retrieve results

Example Request

{
    "client_id": "udyog_aadhaar_GaopvJdtrbTbMgFVoFDK"
}

Process Response

Response Parameters

Parameter	Type	Description
data	object	Contains the complete verification results and business details
data.client_id	string	The unique identifier for this verification request
data.status	string	Status of the verification: "pending", "success", "invalid", "failed", "registration_cancelled", "registration_pending", or "update_pending"
data.uan	string	Udyog Aadhaar Number (UAN) in format UDYAM-XX-##-#######
data.certificate_url	string	Pre-signed URL to download the official Udyog Aadhaar certificate (available only when status is "success" and certificate was requested during initialization)
data.main_details	object	Core enterprise information including classification, ownership, and contact details (populated only when status is "success")
data.main_details.enterprise_type_list	array	Historical record of enterprise classifications (Micro/Small/Medium) across financial years
data.main_details.enterprise_type_list[].classification_year	string	Financial year for the classification (e.g., "2025-26")
data.main_details.enterprise_type_list[].enterprise_type	string	Classification type: "Micro", "Small", or "Medium"
data.main_details.enterprise_type_list[].classification_date	string	Date when classification was assigned (YYYY-MM-DD format)
data.main_details.name_of_enterprise	string	Official registered name of the business entity
data.main_details.major_activity	string	Primary business activity: "Manufacturing" or "Service"
data.main_details.social_category	string	Social category of the enterprise owner (General/SC/ST/OBC)
data.main_details.date_of_commencement	string	Date when business operations began (YYYY-MM-DD format)
data.main_details.dic_name	string	District Industries Centre name where the enterprise is registered
data.main_details.state	string	State where the enterprise is registered
data.main_details.applied_date	string	Date when Udyog Aadhaar registration was applied (YYYY-MM-DD format)
data.main_details.flat	string	Flat/unit number of the registered office address
data.main_details.name_of_building	string	Building name of the registered office
data.main_details.road	string	Road name of the registered office address
data.main_details.village	string	Village name (if applicable)
data.main_details.block	string	Block name within the district
data.main_details.city	string	City of the registered office
data.main_details.pin	string	Postal PIN code of the registered office
data.main_details.mobile_number	string	Registered mobile number (partially masked for privacy)
data.main_details.email	string	Registered email address
data.main_details.organization_type	string	Legal structure: Proprietorship/Partnership/Private Limited/Public Limited/LLP/Cooperative/Self Help Group/Hindu Undivided Family/Others
data.main_details.gender	string	Gender of the enterprise owner (Male/Female/Transgender)
data.main_details.date_of_incorporation	string	Date of business incorporation or registration (YYYY-MM-DD format)
data.main_details.msme_dfo	string	MSME Development and Facilitation Office name
data.main_details.registration_date	string	Official Udyog Aadhaar registration date (YYYY-MM-DD format)
data.location_of_plant_details	array	List of all registered plant/unit locations for the enterprise (populated only when status is "success")
data.location_of_plant_details[].unit_name	string	Name of the manufacturing or service unit
data.location_of_plant_details[].line_1	string	Address line 1 of the plant location
data.location_of_plant_details[].building	string	Building name at the plant location
data.location_of_plant_details[].village	string	Village name where the plant is located
data.location_of_plant_details[].street	string	Street name of the plant address
data.location_of_plant_details[].road	string	Road name of the plant address
data.location_of_plant_details[].city	string	City where the plant is located
data.location_of_plant_details[].pin	string	Postal PIN code of the plant location
data.location_of_plant_details[].state	string	State where the plant is located
data.location_of_plant_details[].district	string	District where the plant is located
data.nic_code	array	National Industrial Classification codes describing business activities (populated only when status is "success")
data.nic_code[].nic_2_digit	string	2-digit NIC code with broad industry category description
data.nic_code[].nic_4_digit	string	4-digit NIC code with more specific activity description
data.nic_code[].nic_5_digit	string	5-digit NIC code with detailed activity description
data.nic_code[].activity_type	string	Type of activity: "Manufacturing" or "Service"
data.nic_code[].added_on	string	Date when this NIC code was added to the registration (YYYY-MM-DD format)
status_code	integer	HTTP status code of the response
success	boolean	Indicates whether the API request was successful
message	string	Human-readable message describing the result
message_code	string	Machine-readable code for the message

Verification Status Values

Status	Description
pending	Verification request is still being processed. Continue polling until status changes
success	Verification completed successfully. Full enterprise details are available in the response
invalid	The provided Udyog Aadhaar number format or content is invalid. No enterprise details available
failed	Verification process failed due to technical issues. Retry the request or contact support
registration_cancelled	The Udyog Aadhaar registration has been cancelled by authorities. No active registration exists
registration_pending	The enterprise's Udyog Aadhaar registration application is pending approval from authorities
update_pending	The enterprise has submitted an update to their registration which is pending approval

Example Successful Response

{
    "data": {
        "client_id": "udyog_aadhaar_GaopvJdtrbTbMgFVoFDK",
        "status": "success",
        "uan": "UDYAM-TN-0X-XXXXXX",
        "certificate_url": "https://dummy-url.com/certificate.html?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=dummy%2F20251016%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251016T071044Z&X-Amz-Expires=600&X-Amz-SignedHeaders=host&X-Amz-Signature=dummysignature",
        "main_details": {
            "enterprise_type_list": [
                {
                    "classification_year": "2025-26",
                    "enterprise_type": "Micro",
                    "classification_date": "2025-04-01"
                },
                {
                    "classification_year": "2024-25",
                    "enterprise_type": "Micro",
                    "classification_date": "2024-04-27"
                },
                {
                    "classification_year": "2023-24",
                    "enterprise_type": "Micro",
                    "classification_date": "2023-05-09"
                },
                {
                    "classification_year": "2022-23",
                    "enterprise_type": "Micro",
                    "classification_date": "2022-06-26"
                }
            ],
            "name_of_enterprise": "Dummy Enterprise",
            "major_activity": "Manufacturing",
            "social_category": "OBC",
            "date_of_commencement": "2013-03-06",
            "dic_name": "Dummy DIC",
            "state": "Dummy State",
            "applied_date": "2020-09-03",
            "flat": "Dummy Address",
            "name_of_building": "Dummy Building",
            "road": "Dummy Road",
            "village": "Dummy Village",
            "block": "Dummy Block",
            "city": "Dummy City",
            "pin": "000000",
            "mobile_number": "99*****000",
            "email": "dummyemail@example.com",
            "organization_type": "Partnership",
            "gender": "Male",
            "date_of_incorporation": "2013-03-06",
            "msme_dfo": "Dummy DFO",
            "registration_date": "2020-09-03"
        },
        "location_of_plant_details": [
            {
                "unit_name": "Dummy Plant",
                "line_1": "Dummy Address",
                "building": "Dummy Building",
                "village": "Dummy Village",
                "street": "Dummy Street",
                "road": "Dummy Road",
                "city": "Dummy City",
                "pin": "000000",
                "state": "Dummy State",
                "district": "Dummy District"
            }
        ],
        "nic_code": [
            {
                "nic_2_digit": "13 - Manufacture of textiles",
                "nic_4_digit": "1399 - Manufacture of other textiles n.e.c.",
                "nic_5_digit": "13999 - Manufacture of other textiles/textile products n.e.c.",
                "activity_type": "Manufacturing",
                "added_on": "2020-09-03"
            }
        ]
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid Client ID

Verification Pending

Invalid Udyog Aadhaar

Registration Cancelled

Registration Pending

Update Pending

Verification Failed

Unauthorized Access

{
    "status_code": 404,
    "success": false,
    "message": "Client ID not found",
    "message_code": "not_found"
}

This error occurs when the provided client_id does not exist in the system. Verify that you're using the correct client_id returned from the Initialize endpoint and that it hasn't expired.

Integration Best Practices

Security Recommendations

Secure Data Storage: Implement encryption at rest for stored enterprise details, especially contact information and certificate URLs

Certificate URL Expiry: Pre-signed certificate URLs typically expire within 10 minutes (600 seconds). Download and store certificates immediately if needed for long-term access

Access Control: Restrict API access to authorized personnel only. Implement role-based access control for viewing sensitive business information

Audit Logging: Maintain comprehensive logs of all verification requests, including timestamps, user identities, accessed client IDs, and returned status values for compliance audits

Data Retention: Define and implement data retention policies compliant with privacy regulations. Automatically purge verification results after the required retention period

PII Protection: The response contains Personally Identifiable Information (mobile numbers, emails). Mask or redact this data in user interfaces where full details aren't necessary

User Experience Guidelines

Polling Strategy: If not using webhooks, implement intelligent polling with exponential backoff (e.g., 2s, 4s, 8s, 16s intervals) to balance responsiveness and API load

Status-Based UI: Design distinct user interface states for each verification status (pending, success, invalid, failed, registration_cancelled, registration_pending, update_pending)

Clear Status Messages: Translate technical status codes into user-friendly messages with appropriate icons and actionable guidance

Data Presentation: Organize complex response data into logical sections (Business Info, Contact Details, Plant Locations, Classifications) for easier comprehension

Historical Trends: Visualize the enterprise_type_list as a timeline to help users understand business growth trajectory across financial years

Certificate Access: Provide a prominent download button for the certificate URL with clear expiry warnings and download confirmation

Error Recovery: For non-success statuses, provide contextual guidance on next steps (verify UAN, wait for approval, contact enterprise owner, retry later)

Loading States: Set realistic expectations about verification times (typically 5-30 seconds) and provide progress updates during polling

Empty State Handling: When status is not "success", clearly communicate why enterprise details are unavailable and what it means for the user's workflow

Code Samples

cURL

Python

Node.js

Related APIs

Udyog Aadhaar Verification - Initialize: Use this endpoint first to initiate the verification process and obtain a client_id before calling the Status endpoint.

GSTIN Verification API: Cross-verify business credentials by validating GST identification numbers to ensure consistency between Udyog Aadhaar and GST registrations.

PAN Verification API: Validate the Permanent Account Number of the business entity for comprehensive KYC checks alongside Udyog Aadhaar verification.

Corporate Identity Verification: Perform additional corporate verification checks including CIN validation for comprehensive business due diligence.

Bulk Udyog Aadhaar Verification: Process multiple Udyog Aadhaar verifications in a single batch request for high-volume use cases.

Compliance and Legal Considerations

Data Privacy: Handle all retrieved business information in compliance with India's data protection regulations and the Digital Personal Data Protection Act. Do not store or share sensitive business data without proper consent and legitimate business purpose.

Purpose Limitation: Use this API only for legitimate business verification purposes such as KYC, vendor onboarding, credit assessment, or compliance verification. Unauthorized or fraudulent use may result in legal consequences and API access revocation.

Record Keeping: Maintain audit logs of all verification requests for compliance and dispute resolution purposes. Include timestamps, user identities, verification outcomes, and the business justification for each check.

Status Interpretation: Different status values require different handling. "registration_cancelled" and "invalid" indicate the UAN cannot be relied upon for business decisions, while "registration_pending" and "update_pending" suggest temporary states that may resolve favorably.

MSME Classification: Enterprise type classifications (Micro/Small/Medium) are based on investment and turnover criteria that may change per government notifications. Always use the most recent classification year from the enterprise_type_list for decision-making.

Certificate Validity: Udyog Aadhaar certificates do not have an expiration date, but businesses should periodically update their registration details. Verify the registration is active (status "success") and not cancelled before relying on the certificate.

Government Source Reliability: This API fetches data directly from government databases. Ensure your use case aligns with government policies on MSME data access and comply with any sector-specific regulations.

Masked Information: Mobile numbers are partially masked in the response for privacy protection. Request full contact details only when absolutely necessary and through appropriate channels with proper authorization.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Status

Udyog Aadhaar Verification - Status#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Verification Status Values#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses