Udyam verification API: validate a Udyam number and check the MSME class

GET /v1/udyam/{regNo} takes the Udyam registration number from a supplier’s invoice or certificate and returns what the MSME register holds for it: the enterprise name, whether it is a micro, small or medium enterprise, its activity and its addresses. No OTP from the owner is needed.

Free sample with the test number UDYAM-XX-00-0000000, no credit used. Live calls need an account that has bought a credit pack.

Why buyers check a supplier’s Udyam registration

Under section 43B(h) of the Income Tax Act, an amount you owe to a micro or small supplier is deductible only in the year you actually pay it if it stays unpaid beyond the time the MSMED Act allows: 15 days with no written agreement, and at most 45 days with one. Whether a supplier counts as micro or small therefore matters before you plan a payment run.

The supplier’s Udyam registration is where that class is recorded. This endpoint reads it for you, so your accounts payable team does not have to open the Udyam portal for every vendor.

Check how the rule applies to you with your tax adviser. The API gives you the class on record, not tax advice.

What comes back

The size class is profile.enterprise_type, and enterprise_type_history shows how it changed year by year. Dates are DD/MM/YYYY, and fields the register leaves blank come back as null.

The mobile number comes back partly masked, as in 98*****210, not in full. The email comes back as the register holds it. The owner’s date of birth is returned only when the register holds one, so it can be null: do not build a process that needs it.

FieldExampleWhat it is
foundtruefalse when no registration exists on that number
profile.enterprise_nameEXAMPLE ENTERPRISESThe name on the registration
profile.enterprise_typeMicroThe size class: Micro, Small or Medium
profile.major_activityServicesThe main activity
profile.organization_typeProprietaryThe legal form
enterprise_type_history2024-25: MicroThe class, year by year
industryNIC code and activity descriptionWhat the enterprise does
official_address, branch_detailsSurat, Gujarat, 395002The addresses on record
udyam_categoryUdyam Registration CertificateThe kind of certificate, not the size

A request and a response

GET /v1/udyam/UDYAM-GJ-01-0123456 with your key in the x-api-key header returns the register entry. The number can be sent in upper or lower case, and Udyam Assist numbers such as UDYAM-I-GJ-01-0123456 are accepted. A call usually takes a few seconds.

What it costs

Each call is 7 credits from the same balance as every other call, whichever pack you bought. In rupees, before 18% GST, that is:

  • A well-formed number with no registration is charged, because the lookup was made, and the response says found: false.
  • A malformed number, a temporary outage and a reached daily limit cost nothing.
  • Credits are shared with GSTIN lookups and never expire.
PackPer creditPer Udyam call
Starter₹0.80₹5.60
Business₹0.50₹3.50
Scale₹0.40₹2.80
Enterprise₹0.30₹2.10

What it does and does not do

  • It validates a registration number and returns what the register holds. It does not prove that the person you are dealing with owns that registration: compare the enterprise name and address with the supplier’s own documents, or check its GSTIN as well.
  • The answer can include the owner’s gender and date of birth and the registration’s email and mobile number. These are personal data: use them for the purpose you looked them up for. The mobile number is partly masked and the date of birth can be blank, so they do not replace asking the supplier for its contact details.
  • Because of that, the endpoint is for accounts that have bought a credit pack, allows 500 lookups per account per day, and nothing is cached.
  • The class shown is the one the register holds at the time of the call; enterprise_type_history shows the earlier years.
  • To check a GSTIN, use the GST verification API. To find the GSTINs under a PAN, use the PAN to GSTIN search.

Frequently asked questions

Is there an API to validate a Udyam registration number?

Yes. GET /v1/udyam/{regNo} returns the enterprise name, size class, activity and addresses for a Udyam or Udyam Assist number, without an OTP from the owner.

How do I find out whether a supplier is a micro or small enterprise?

Send its Udyam number. The class is in profile.enterprise_type, and enterprise_type_history shows how it changed year by year.

How much does a Udyam check cost?

7 credits a call, which is ₹2.80 on the Scale pack, ₹3.50 on Business, ₹5.60 on Starter and ₹2.10 on Enterprise, before GST. Credits never expire and are shared with the other endpoints.

Is a Udyam number with no registration charged?

Yes, because the lookup was made and the answer is that no registration exists. A malformed number, an outage and a reached daily limit are free.

Does it need an OTP from the supplier?

No. You send the registration number only.

Does it work for Udyam Assist numbers?

Yes. Send UDYAM-I-SS-DD-NNNNNNN in the same way as a regular Udyam number.

Can I try it before buying a pack?

Yes. GET /v1/udyam/UDYAM-XX-00-0000000 with your API key returns a fixed sample in the live response shape and costs nothing. Live calls need an account that has bought a credit pack.

Do you return the full phone number and the date of birth?

No, not the full phone number: the mobile number comes back partly masked, with the first two and last three digits shown, as in 98*****210. The email comes back as the register holds it. The date of birth is returned only when the register holds one and can be blank, so we cannot promise it for every number.

Is Udyam data personal data?

Part of it is. The answer can include the owner’s gender and date of birth and the registration’s email and mobile number, so use it only for the purpose you checked the supplier for. That is also why the endpoint has a daily limit.

Start with up to 75 free lookups

10 on signup and 65 more across three setup steps. No card, and they never expire.

Create a free account