Skip to content

MSME Details ​

Retrieve detailed MSME (Micro, Small, and Medium Enterprise) registration information using an Udyam Registration Number, including enterprise type classification history, address, incorporation dates, and activity type.

Endpoint ​

POST /vas-api/get-msme-details-v1

Authentication ​

Requires OAuth2 Bearer token. Get your credentials →

Request ​

Headers ​

HeaderTypeRequiredDescription
AuthorizationstringYesBearer YOUR_ACCESS_TOKEN
Content-TypestringYesapplication/json

Body parameters ​

FieldTypeRequiredDescriptionExample
msme_nostringYesUdyam Registration Number (format: UDYAM-XX-00-0000000)UDYAM-MH-10-0003502

Example request ​

bash
curl -X POST https://api.api4business.com/vas-api/get-msme-details-v1 \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"msme_no": "UDYAM-MH-10-0003502"}'
python
import requests

response = requests.post(
  "https://api.api4business.com/vas-api/get-msme-details-v1",
  headers={
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  json={"msme_no": "UDYAM-MH-10-0003502"}
)
print(response.json())
javascript
const response = await fetch(
  "https://api.api4business.com/vas-api/get-msme-details-v1",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_ACCESS_TOKEN",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({ msme_no: "UDYAM-MH-10-0003502" })
  }
);
console.log(await response.json());
java
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
  .uri(URI.create("https://api.api4business.com/vas-api/get-msme-details-v1"))
  .header("Authorization", "Bearer YOUR_ACCESS_TOKEN")
  .header("Content-Type", "application/json")
  .POST(HttpRequest.BodyPublishers.ofString("{\"msme_no\": \"UDYAM-MH-10-0003502\"}"))
  .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response ​

Success (200) ​

FieldTypeDescription
okbooleantrue if successful
responseCodenumberHTTP status code
messagestringStatus message
body.enterpriseNamestringRegistered enterprise name
body.activitystringPrimary business activity (e.g., TRADING, MANUFACTURING)
body.dicstringDistrict Industries Centre
body.doistringDate of incorporation (DD/MM/YYYY)
body.docpstringDate of commencement of production (DD/MM/YYYY)
body.dourstringDate of Udyam registration (DD/MM/YYYY)
body.enterpriseAddressobjectFull enterprise address with building, block, city, district, state, pin, email, mobile
body.enterpriseTypearrayClassification history with type (Micro/Small/Medium), classification date, and data year

Example response ​

json
{
  "ok": true,
  "responseCode": 200,
  "message": "Transmission OK",
  "body": {
    "enterpriseName": "SAMPLE AUTOMOBILES",
    "activity": "TRADING",
    "dic": "MUMBAI",
    "doi": "15/03/2020",
    "docp": "15/03/2020",
    "dour": "16/11/2021",
    "enterpriseAddress": {
      "building": "SAMPLE COMPLEX",
      "block": "ANDHERI",
      "city": "MUMBAI",
      "district": "MUMBAI",
      "state": "MAHARASHTRA",
      "pin": "400059",
      "road": "MAIN ROAD",
      "email": "sample@example.com",
      "mobile": "91*****000"
    },
    "enterpriseType": [
      {
        "enterpriseType": "Micro",
        "classificationDate": "09/05/2023",
        "classificationYear": "2023-24",
        "dataYear": "2021-22",
        "sNo": "1"
      }
    ]
  }
}

Response headers ​

HeaderDescription
x-request-idUnique request identifier — log this for debugging and support

Error responses ​

StatusError CodeMessageResolution
400400Invalid Udyam number format!Check format: UDYAM-XX-00-0000000 (XX = state code)
400400Invalid RequestVerify JSON body contains msme_no field
401401Invalid CredentialsAccess token expired — request a new one
429429Quota ViolationRate limit exceeded — retry with backoff
500500Internal Server ErrorRetry after delay
503503Service Not AvailableUdyam portal temporarily down — retry

Released under the API4Business Terms of Service