Udyam Verification API
Send a Udyam registration number and confirm the enterprise, its MSME class, its activity and its units in one call.
The documentation opens in the VerifyAll dashboard after sign-in, for accounts with approved API access. New to the API? Start with the developer guide.
Overview
What the Udyam Verification API does
The Udyam Verification API takes a Udyam registration number (UDYAM-XX-00-0000000) and confirms the MSME registration behind it: the enterprise name, its current class (Micro, Small or Medium), its major activity (Manufacturing, Services or Trading), its type of organisation, the dates of incorporation, commencement and Udyam registration, the district industries centre, the official address, its plants and units, its NIC codes and its classification year by year.
MSME status has money attached to it. Buyers must pay registered micro and small suppliers within set timelines, lenders run priority-sector and MSME schemes, and tenders carry MSME preferences. A Udyam certificate shown as a PDF or a photo is easy to alter; the API confirms the number and returns the class and activity on record, so your system decides on facts rather than a document.
The classification history matters when a supplier has grown. An enterprise that was Micro two years ago may be Small or Medium today, and the year-by-year list shows when that changed. If you have the business’s PAN but not its Udyam number, use the PAN to Udyam API instead.
How it works
- 1
Your server sends POST /universal/udyam-verification with the udyam_number and, if you like, a client_ref. A check about a business takes no consent object.
- 2
The request is checked first: a number that does not match the UDYAM-XX-00-0000000 format is refused with 400 invalid_request, before anything runs or is charged.
- 3
The Udyam number is checked against live records and the registration details come back in the same call, usually within about 5 seconds.
- 4
The result is stored in your VerifyAll account with a checkResultId, so you can read it again, find it by your client_ref and download the Udyam verification PDF report.
Request and response
Udyam verification API endpoints and fields
The main fields; the full reference with every field, error code and a cURL sample is in the dashboard docs.
| Endpoint | What it does |
|---|---|
| POST/universal/udyam-verification | Verify a Udyam registration number |
Request fields
| Field | What it is |
|---|---|
| udyam_numberRequired | The Udyam registration number, for example UDYAM-MH-12-0001234. |
| client_refOptional | Your own reference, stored with the result (up to 100 characters). |
What the answer returns
| Field | What it is |
|---|---|
| udyam_number | The Udyam registration number, which may be partly masked. |
| enterprise_name | The name of the enterprise. |
| enterprise_type | Current classification: Micro, Small or Medium. |
| major_activity | Manufacturing, Services or Trading. |
| organisation_type / social_category | Proprietary, Partnership, Private Limited Company and so on; the social category of the owner as registered. |
| incorporated_on / commenced_on / registered_on | Dates of incorporation, of commencement of business, and of Udyam registration, YYYY-MM-DD. |
| district_industries_centre | The district industries centre of the enterprise. |
| official_address | The enterprise’s official address, in parts and on one line. |
| units | Plants and units of the enterprise, each with its name and address. |
| classification_history | Classification year by year: data year, classification year, Micro/Small/Medium and the date classified. |
| nic_codes | NIC 2-, 4- and 5-digit codes with names, the activity and the date each was added. |
Base URL https://api.verifyall.ai. Authenticate with the X-API-Key header (a va_sandbox_ or va_live_ key). Every answer carries data, status_code, success, message and message_code; checks add outcome, checkResultId, charged and charged_amount.
Key features
Udyam Verification API features and capabilities
MSME class you can rely on
enterprise_type gives Micro, Small or Medium as it stands now, the field payment-term and scheme rules depend on.
Year-by-year classification
See when an enterprise moved from Micro to Small or Medium, useful for scheme eligibility and supplier payment terms.
NIC codes and activity
The industry codes on record let you confirm that a supplier actually makes or trades what it sells you.
Plants and units
Every unit with its address, for site visits, logistics planning and checking a delivery location.
Use cases
Where businesses use the Udyam Verification API
MSME supplier classification
Tag suppliers as Micro, Small or Medium in your ERP so payment timelines and reporting follow the right rules.
MSME lending
Confirm a borrower’s Udyam registration, activity and class before an MSME loan or scheme benefit.
Tender and procurement eligibility
Check the Udyam number a bidder quotes for an MSME preference.
Merchant and distributor onboarding
Verify the Udyam number a small business gives at sign-up and compare its address with the one it entered.
Industries
Coverage
Udyam registration numbers issued in India, for micro, small and medium enterprises.
Limitations to plan for
- The request needs the Udyam number. If you have only the PAN, use the PAN to Udyam API.
- The Udyam number in the answer may be partly masked.
- A number with no record answers record_not_found. The lookup ran, so it is charged.
- Fields the record does not hold come back as null or as an empty list, never guessed.
Integration
How to integrate the Udyam Verification API
From a business account to your first live call.
Step 1
Create a business account on VerifyAll and get it approved, as for running checks in the dashboard.
Step 2
Request Developer API access under Developers in the dashboard: the APIs you need, your expected monthly volume and your use case. The VerifyAll team reviews it and shares the API Services Agreement.
Step 3
Once the agreement is signed and access is approved, create your Sandbox key and build against sample data. Sandbox calls are never charged.
Step 4
Create your Production key, recharge your wallet and switch the key in your code: the endpoint and fields stay the same.
Get started
Request access to the Udyam Verification API
Tell us what you want to verify. We reply within one business day with access steps, Sandbox details and your API pricing.
View API documentation
The full reference for Udyam Verification API (endpoints, fields, errors, cURL) opens in the dashboard once your access is approved.
Open the docs (sign-in)Create a business account
API keys are issued to an approved business account. Sign up, then request access under Developers.
Create account
Pricing
Production calls are charged per check from your prepaid VerifyAll wallet, at your account’s API price; GST is added separately when you recharge. Sandbox calls are never charged. Your API prices are shown in the dashboard once access is approved. How pricing works
Already have a business account? Sign in to request access
Udyam Verification API: frequently asked questions
Answers for teams planning an integration.
Still have questions? Our team is happy to help.
Contact SupportRelated APIs
PAN to Udyam API
LiveInstant answerSend a PAN and find out whether the business is MSME-registered, with its Udyam number, class and certificate.
View API detailsGST Verification API
LiveInstant answerSend a GSTIN and get the business behind it: names, status, place of business and the returns it has filed, in one call.
View API detailsBasic Business Verification API
LiveFinishes laterOne request runs the business checks a KYB review needs and returns one report with an overall result.
View API detailsBulk Verification API
LiveBulk batchSend a whole list of PANs or GSTINs in one request and read back each row’s result, in the same shape as the single check.
View API details
All business verification (KYB) APIsRun Udyam verification in the dashboard, without codeBrowse the API Marketplace
Start with the Udyam Verification API
Request access, build against the Sandbox, then go live with your Production key.