Udyog Aadhaar Verification API

Endpoint Overview

POST /api/v1/corporate/udyog-aadhaar

Description

The Udyog Aadhaar Verification API allows you to validate and retrieve comprehensive details of businesses registered under the Udyog Aadhaar scheme in India. By providing a valid Udyog Aadhaar Number (UAN), you can access official business registration information, including enterprise details, plant locations, and industrial classification codes.

Key Benefits

Instant verification of Udyog Aadhaar registration status

Access to comprehensive business details including enterprise type, location, and classification

Retrieve official certificate URL for documentation purposes

Verify business legitimacy for KYC, lending, and partnership decisions

Use Cases

Financial Services

B2B Services

Government & Compliance

Verify business credentials before approving business loans

Validate MSME status for specialized lending programs

Confirm business details for 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
id_number	String	Yes	Valid Udyog Aadhaar Number (UAN)
get_certificate	Boolean	No	Get Udyam Certificate

Example Request

{
    "id_number": "UDYAM-GJ-25-00000000"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains all verification data
data.client_id	String	Unique client identifier
data.uan	String	Udyog Aadhaar Number
data.certificate_url	String	URL to download the Udyog Aadhaar certificate
data.main_details	Object	Enterprise details (see table below)
data.location_of_plant_details	Array of Objects	Plant location details (see table below)
data.nic_code	Array of Objects	National Industrial Classification code details (see table below)
status_code	Integer	HTTP status code
success	Boolean	Indicates if the request was successful
message	String	Additional message (null if successful)
message_code	String	Message code for the response

Main Details Object

Parameter	Type	Description
enterprise_type_list	Array of Objects	Enterprise type classification by year
name_of_enterprise	String	Name of the enterprise
major_activity	String	Enterprise's major activity
social_category	String	Social category of the enterprise
date_of_commencement	String	Date of commencement (YYYY-MM-DD)
dic_name	String	District Industries Centre name
state	String	State name
applied_date	String	Udyam registration date (YYYY-MM-DD)
flat	String	Flat number
name_of_building	String	Building name
road	String	Road name
village	String	Village name
block	String	Block name
city	String	City name
pin	String	Pincode
mobile_number	String	Mobile number (partially masked)
email	String	Email address
organization_type	String	Type of organization
gender	String	Gender of enterprise owner
date_of_incorporation	String	Date of incorporation (YYYY-MM-DD)
msme_dfo	String	Development and Facilitation Office
registration_date	String	Registration date (YYYY-MM-DD)

Location of Plant Details Object

Parameter	Type	Description
unit_name	String	Name of the unit
line_1	String	Flat or plot number
building	String	Building name
village	String	Village name
street	String	Street name
road	String	Road name
city	String	City name
pin	String	Pincode
state	String	State name
district	String	District name

NIC Code Object

Parameter	Type	Description
nic_2_digit	String	2-digit NIC code
nic_4_digit	String	4-digit NIC code
nic_5_digit	String	5-digit NIC code
activity_type	String	Type of activity
added_on	String	Date added (YYYY-MM-DD)

Example Successful Response

{
    "data": {
        "client_id": "uan_ANxqiNhrnwBbYwysUEvh",
        "uan": "UDYAM-GJ-25-000000",
        "certificate_url": "",
        "main_details": {
            "enterprise_type_list": [
                {
                    "classification_year": "2023-24",
                    "enterprise_type": "Micro",
                    "classification_date": "2023-05-09"
                },
                {
                    "classification_year": "2022-23",
                    "enterprise_type": "Micro",
                    "classification_date": "2022-06-26"
                },
                {
                    "classification_year": "2021-22",
                    "enterprise_type": "Micro",
                    "classification_date": "2022-04-16"
                }
            ],
            "name_of_enterprise": " INDUSTRIES",
            "major_activity": "Manufacturing",
            "social_category": "General",
            "date_of_commencement": "2012-10-17",
            "dic_name": "XXXXXX",
            "state": "AAAAAA",
            "applied_date": "2022-04-16",
            "flat": "106/9",
            "name_of_building": "3RD PHASE",
            "road": "XXXXX",
            "village": "XXXXX",
            "block": "NA",
            "city": "VAPI",
            "pin": "XXXXX",
            "mobile_number": "XX*****XXX",
            "email": "XXXXXXXXX@GMAIL.COM",
            "organization_type": "Proprietary",
            "gender": "Male",
            "date_of_incorporation": "0000-10-17",
            "msme_dfo": "XXXXXXX",
            "registration_date": "00000-04-16"
        },
        "location_of_plant_details": [
            {
                "unit_name": "XX*************XX",
                "line_1": "C-104, 14/3",
                "building": "XXXXXXXXXX SOCIETY",
                "village": "XXX",
                "street": "",
                "road": "BEHIND AAAAA COLLEGE",
                "city": "AAAAA",
                "pin": "000000",
                "state": "AAAAAA",
                "district": "AAAAA"
            },
            {
                "unit_name": "ABCD INDUSTRIES",
                "line_1": "106/9",
                "building": "3RD ",
                "village": "MILLS LTD",
                "street": "",
                "road": "ABCD",
                "city": "ABCd",
                "pin": "000000",
                "state": "ABCD",
                "district": "YYYYYY"
            }
        ],
        "nic_code": [
            {
                "nic_2_digit": " 0; management consultancy activities",
                "nic_4_digit": "Management consultancy activities",
                "nic_5_digit": "Management consultancy activities",
                "activity_type": "Services",
                "added_on": "0000-04-16"
            },
            {
                "nic_2_digit": "0: machinery and equipment",
                "nic_4_digit": "2599 -  of other fabricate n.e.c.",
                "nic_5_digit": "25999 - Manufacture of other fabricated metal products n.e.c.",
                "activity_type": "Manufacturing",
                "added_on": "0000-04-16"
            }
        ]
    },
    "status_code": 200,
    "success": true,
    "message": null,
    "message_code": "success"
}

Possible Error Responses

Invalid UAN

UAN Not Found

Authentication Error

{
    "status_code": 400,
    "success": false,
    "message": "Invalid Udyog Aadhaar Number format",
    "message_code": "invalid_input"
}

The provided Udyog Aadhaar Number is invalid or in an incorrect format.

Integration Best Practices

Security Recommendations

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

Implement proper error handling to avoid exposing sensitive information

Use HTTPS for all API communications

Implement rate limiting in your application to prevent abuse

Regularly rotate authentication credentials

User Experience Guidelines

Implement proper loading states while waiting for API responses

Display clear error messages to users when verification fails

Cache verification results when appropriate to improve performance

Format dates and addresses in a user-friendly manner

Provide clear instructions on how to find and enter the Udyog Aadhaar Number

Code Samples

cURL

Python

Node.js

Related APIs

PAN Verification API - Verify Permanent Account Number details

GST Verification API - Verify Goods and Services Tax registration details

Company Verification API - Verify registered company information

Shop & Establishment API - Verify shop and establishment registration details

Compliance and Legal Considerations

The Udyog Aadhaar data is governed by MSME regulations in India. Ensure you have proper consent before verifying business information. Some data may be partially masked for privacy reasons. The API should be used in compliance with data protection regulations and the terms of service provided by Surepass.

{ "data": { "client_id": "uan_ANxqiNhrnwBbYwysUEvh", "uan": "UDYAM-GJ-25-000000", "certificate_url": "", "main_details": { "enterprise_type_list": [ { "classification_year": "2023-24", "enterprise_type": "Micro", "classification_date": "2023-05-09" }, { "classification_year": "2022-23", "enterprise_type": "Micro", "classification_date": "2022-06-26" }, { "classification_year": "2021-22", "enterprise_type": "Micro", "classification_date": "2022-04-16" } ], "name_of_enterprise": " INDUSTRIES", "major_activity": "Manufacturing", "social_category": "General", "date_of_commencement": "2012-10-17", "dic_name": "XXXXXX", "state": "AAAAAA", "applied_date": "2022-04-16", "flat": "106/9", "name_of_building": "3RD PHASE", "road": "XXXXX", "village": "XXXXX", "block": "NA", "city": "VAPI", "pin": "XXXXX", "mobile_number": "XX*****XXX", "email": "XXXXXXXXX@GMAIL.COM", "organization_type": "Proprietary", "gender": "Male", "date_of_incorporation": "0000-10-17", "msme_dfo": "XXXXXXX", "registration_date": "00000-04-16" }, "location_of_plant_details": [ { "unit_name": "XX*************XX", "line_1": "C-104, 14/3", "building": "XXXXXXXXXX SOCIETY", "village": "XXX", "street": "", "road": "BEHIND AAAAA COLLEGE", "city": "AAAAA", "pin": "000000", "state": "AAAAAA", "district": "AAAAA" }, { "unit_name": "ABCD INDUSTRIES", "line_1": "106/9", "building": "3RD ", "village": "MILLS LTD", "street": "", "road": "ABCD", "city": "ABCd", "pin": "000000", "state": "ABCD", "district": "YYYYYY" } ], "nic_code": [ { "nic_2_digit": " 0; management consultancy activities", "nic_4_digit": "Management consultancy activities", "nic_5_digit": "Management consultancy activities", "activity_type": "Services", "added_on": "0000-04-16" }, { "nic_2_digit": "0: machinery and equipment", "nic_4_digit": "2599 - of other fabricate n.e.c.", "nic_5_digit": "25999 - Manufacture of other fabricated metal products n.e.c.", "activity_type": "Manufacturing", "added_on": "0000-04-16" } ] }, "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 ********************

Udyog Aadhaar

Udyog Aadhaar Verification API#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Main Details Object#

Location of Plant Details Object#

NIC Code Object#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses