Udyam Verification

✅
Recommended - Simple Udyam Verification Flow
We have one step process to Verify Udyam Aadhaar Number in Validate API. Refer here for the product guide

Decentro brings Udyam Verification API which the customer can use to validate and fetch information related to a valid Udyam Number. Udyam is also known as MSME (Ministry of Micro, Small & Medium Enterprises).

Companies can get their Udyam Certificate to certify that they are small or medium businesses or enterprises.

Product Flow

There are two APIs in the flow to validate Udyam. Below are APIs to use in the sequence -

Initiate Session - This API initiates a session that gives a captcha in Base64 format.
Validate Udyam - This API requires two pieces of information from the Initiate Session API along with udyam_number -
a) Initiation Decentro Transaction ID - This comes in the response of the Initiate Session API.
b) Captcha - A valid captcha to pass in the request body parameter of Validate Udyam

Initiate Session

This API initiates a valid session with Udyam. It gives the following that has to be passed mandatorily in the Validate Udyam API -

Captcha
Decentro Transaction ID

{
    "reference_id": "3a79105d-bb14-4f7c-be3f-02c89ff9ccea",
    "consent": true,
    "purpose": "For Udyam Verification"
}

{
  "decentroTxnId": "DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "status": "SUCCESS",
  "responseCode": "S00000",
  "message": "Session created successfully.",
  "data": {
    "captchaBase64": "Base64 of Captcha"
  },
  "responseKey": "success_session_created"
}

Validate Udyam

This API validates the Udyam. Udyam Number has to be passed in the request body for this API along with a captcha and initiation_transaction_id.

{
    "reference_id": "d027b856-1ac9-4e80-9324-1f5f161aaa24",
    "initiation_transaction_id": "DXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "udyam_number": "UDYAM-AA-00-0000000",
    "captcha": "Q5R5PC",
    "consent": true,
    "purpose": "For Udyam Verification"
}

{
  "decentroTxnId": "DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "status": "SUCCESS",
  "responseCode": "S00000",
  "message": "Successfully fetched details for the given Udyam number.",
  "data": {
    "udyamNumber": "UDYAM-AA-00-0000000",
    "enterpriseName": "M/S XXXXX XXXXX",
    "organisationType": "Private Limited Company",
    "majorActivity": "Services",
    "gender": "Male",
    "socialCategory": "General",
    "incorporationDate": "DD/MM/YYYY",
    "commencementDate": "DD/MM/YYYY",
    "enterpriseOfficialAddress": {
      "flat": "XXXX",
      "building": "XXXXXXXXXXXXXXXXXXX",
      "village": "XXXXXXXXXXXX",
      "block": "-",
      "street": "XXXXXXXXXXXXXXXXXXX",
      "city": "XXXXXXXXXXXX",
      "state": "XXXXXXXXXXXX",
      "district": "BENGALURU (URBAN)",
      "mobile": "XX*****XXX",
      "email": "XXXXXXXXXXXXXXXXX"
    },
    "dic": "BANGALORE (URBAN)",
    "msmeDfo": "BANGALORE",
    "udyamRegistrationDate": "DD/MM/YYYY",
    "enterpriseType": {
      "serialNumber": "1",
      "dataYear": "2020-21",
      "classificationYear": "2022-23",
      "enterpriseType": "Micro",
      "classificationDate": "DD/MM/YYYY"
    },
    "unitLocationDetails": {
      "serialNumber": "1",
      "unitName": "XXXXXXXXXXXXXXXXX",
      "flat": "XXXX",
      "building": "XXXXXXXXXXXXXXXXXXX",
      "village": "XXXXXXXXXXXXXXXXXXX",
      "block": "",
      "road": "XXXXXXXXXXXXXXXXXXX",
      "city": "XXXXXXXXXXXX",
      "pin": "XXXXXX",
      "state": "KARNATAKA",
      "district": "BENGALURU (URBAN)"
    },
    "nationalIndustryClassificationCode": {
      "serialNumber": "1",
      "nic2Digit": "XX - Computer programming, consultancy and related activities",
      "nic4Digit": "XXXX - Other information technology and computer service activities",
      "nic5Digit": "XXXXX - Other information technology and computer service activities n.e.c",
      "activity": "Services",
      "date": "DD/MM/YYYY"
    }
  },
  "responseKey": "success_udyam_verification"
}