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

Header	Type	Required	Description
Authorization	string	Yes	Bearer YOUR_ACCESS_TOKEN
Content-Type	string	Yes	application/json

Body parameters

Field	Type	Required	Description	Example
msme_no	string	Yes	Udyam Registration Number (format: UDYAM-XX-00-0000000)	UDYAM-MH-10-0003502

Example request

curl

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())

Node.js

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)

Field	Type	Description
ok	boolean	true if successful
responseCode	number	HTTP status code
message	string	Status message
body.enterpriseName	string	Registered enterprise name
body.activity	string	Primary business activity (e.g., TRADING, MANUFACTURING)
body.dic	string	District Industries Centre
body.doi	string	Date of incorporation (DD/MM/YYYY)
body.docp	string	Date of commencement of production (DD/MM/YYYY)
body.dour	string	Date of Udyam registration (DD/MM/YYYY)
body.enterpriseAddress	object	Full enterprise address with building, block, city, district, state, pin, email, mobile
body.enterpriseType	array	Classification history with type (Micro/Small/Medium), classification date, and data year

Example response

{
  "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

Header	Description
x-request-id	Unique request identifier — log this for debugging and support

Error responses

Status	Error Code	Message	Resolution
400	400	Invalid Udyam number format!	Check format: UDYAM-XX-00-0000000 (XX = state code)
400	400	Invalid Request	Verify JSON body contains msme_no field
401	401	Invalid Credentials	Access token expired — request a new one
429	429	Quota Violation	Rate limit exceeded — retry with backoff
500	500	Internal Server Error	Retry after delay
503	503	Service Not Available	Udyam portal temporarily down — retry

Related

• PAN to MSME — Find MSME registration by PAN
• CIN Details — Get company details from CIN
• Company Verification Overview