Udyam Verification (without OTP)
1 endpoint · Core API
Udyam Verification is a pivotal process for Micro, Small, and Medium Enterprises (MSMEs), involving registration with the Ministry of MSMEs to obtain a unique Udyam Registration Number or Udyam Aadhaar Number.
Advantages of Udyam Verification
Access to loans without requiring collateral: MSMEs can secure financial assistance from banks without the need for collateral. Financial incentives and benefits: This verification offers significant subsidies for patent registration, reduced electricity bills, and reimbursement for ISO certification expenses. Expanded business prospects: MSMEs with Udyam Verification gain preferential access to government tenders, facilitating business expansion.
What you can do
This API validates Udyam registration without requiring OTP and provides access to details of the registered Udyam entity, simplifying authentication processes and facilitating easy retrieval of information.
Udyam Verification details
Headers
- X-API-KEYstringrequiredYour secret API key for the environment you are calling (Stage and Live use different keys).
- X-API-APP-IDstringrequiredThe App ID issued together with the key.
- Content-Typestringrequiredapplication/json
Body parameters
application/json- consentstringrequiredRequired. The end user's consent to this verification. Send `Y`.minLength 1default Y
- consent_textstringrequiredRequired. The consent statement shown to the end user. Send the default text from the sample.minLength 1default I hear by declare my consent agreeme…
- request_idstringoptionalOptional. Your own id to correlate this call in your logs. A unique id is generated if you leave it out.nullable
- udyamRegistrationNostringrequiredRequired. Udyam registration number in the format UDYAM-XX-00-0000000: the word UDYAM in uppercase, a 2-letter state code, 2 digits and 7 digits, separated by hyphens.minLength 1pattern ^UDYAM-[A-Z]{2}-\d{2}-\d{7}$default UDYAM-MP-23-0007772
- isPDFRequiredstringrequiredRequired. Send "Y" to get a PDF copy of the registration certificate, or "N" to skip it (Y, y, N or n).minLength 1pattern ^[YyNn]{1}$default Y
- getEnterpriseDetailsstringrequiredRequired. Send "Y" to include the enterprise details in the response, or "N" to skip them (Y, y, N or n).minLength 1pattern ^[YyNn]{1}$default Y
Sample request body
Responses
200OK
- successbooleanoptionalNo description.
- statusCodeinteger (int32)optionalNo description.default 200
- messagestringoptionalNo description.nullabledefault XXXXX
- dataobjectoptionalResponse model containing comprehensive Udyam registration verification details.
14 fields
- udyamRegistrationNostringoptionalThe Udyam registration number of the enterprise.nullable
- dateOfRegistrationstringoptionalDate when the enterprise was registered under Udyam.nullable
- interestedInTredsstringoptionalIndicates whether the enterprise is interested in TReDS (Trade Receivables Discounting System).nullable
- interestedInGemstringoptionalIndicates whether the enterprise is interested in GeM (Government e-Marketplace).nullable
- profileobjectoptionalProfile information of the Udyam-registered enterprise.
15 fields
- namestringoptionalName of the enterprise.nullable
- majorActivitystringoptionalMajor activity of the enterprise (e.g., manufacturing, services).nullable
- organizationTypestringoptionalType of organization (e.g., proprietorship, partnership, company).nullable
- ownerNamestringoptionalName of the enterprise owner.nullable
- panstringoptionalPAN (Permanent Account Number) of the enterprise or owner.nullable
- previousITRStatusstringoptionalStatus of the previous Income Tax Return filing.nullable
- itrTypestringoptionalType of Income Tax Return filed.nullable
- gstnStatusstringoptionalGSTN (GST Number) registration status of the enterprise.nullable
- mobilestringoptionalMobile number of the enterprise owner.nullable
- emailIdstringoptionalEmail address of the enterprise owner.nullable
- socialCategorystringoptionalSocial category of the enterprise owner (e.g., General, SC, ST, OBC).nullable
- genderstringoptionalGender of the enterprise owner.nullable
- speciallyAbledstringoptionalIndicates whether the owner is specially abled.nullable
- dateOfIncorporationstringoptionalDate of incorporation of the enterprise.nullable
- dateOfCommencementstringoptionalDate when the enterprise commenced operations.nullable
- bankDetailsobjectoptionalBank account details of the Udyam-registered enterprise.
3 fields
- bankstringoptionalName of the bank where the enterprise account is held.nullable
- ifscstringoptionalIFSC code of the bank branch.nullable
- acNostringoptionalBank account number of the enterprise.nullable
- employmentDetailsobjectoptionalEmployment details of the enterprise including gender-wise employee count.
4 fields
- maleinteger (int32)optionalNumber of male employees.nullable
- femaleinteger (int32)optionalNumber of female employees.nullable
- othersinteger (int32)optionalNumber of employees of other gender categories.nullable
- totalinteger (int32)optionalTotal number of employees in the enterprise.nullable
- financialsobjectoptionalFinancial information of the enterprise for a specific fiscal year.
2 fields
- financialYearstringoptionalThe fiscal year for which financial details are reported.nullable
- detailsobjectoptionalFinancial figures for a specific metric of the enterprise.
6 fields
- wdvPmenumber (double)optionalWritten Down Value of plant, machinery, and equipment.nullable
- exclusionnumber (double)optionalExclusion amount from the investment calculation.nullable
- netInvestmentInPmenumber (double)optionalNet investment in plant, machinery, and equipment.nullable
- totalTurnovernumber (double)optionalTotal turnover of the enterprise.nullable
- exportTurnovernumber (double)optionalExport turnover of the enterprise.nullable
- netTurnovernumber (double)optionalNet turnover after deducting export turnover.nullable
- branchDetailsarray<object>optionalList of branch offices of the enterprise.nullable
Each item: 10 fields
- namestringoptionalName of the branch.nullable
- flatstringoptionalFlat or unit number of the branch address.nullable
- premisesstringoptionalBuilding or premises name of the branch address.nullable
- villagestringoptionalVillage or locality of the branch address.nullable
- blockstringoptionalBlock or area of the branch address.nullable
- roadstringoptionalRoad or street name of the branch address.nullable
- citystringoptionalCity of the branch address.nullable
- statestringoptionalState of the branch address.nullable
- pincodestringoptionalPostal PIN code of the branch address.nullable
- districtstringoptionalDistrict of the branch address.nullable
- officialAddressobjectoptionalOfficial registered address of the Udyam enterprise.
11 fields
- flatstringoptionalFlat or unit number.nullable
- premisesstringoptionalBuilding or premises name.nullable
- villagestringoptionalVillage or locality.nullable
- blockstringoptionalBlock or area.nullable
- roadstringoptionalRoad or street name.nullable
- citystringoptionalCity name.nullable
- statestringoptionalState name.nullable
- pincodestringoptionalPostal PIN code.nullable
- districtstringoptionalDistrict name.nullable
- emailstringoptionalEmail address associated with the official address.nullable
- mobilestringoptionalMobile number associated with the official address.nullable
- industryarray<object>optionalList of industries the enterprise is associated with.nullable
Each item: 7 fields
- industrystringoptionalName of the industry.nullable
- subSectorstringoptionalSub-sector within the industry.nullable
- activityDescriptionstringoptionalDescription of the business activity.nullable
- industryCodestringoptionalCode identifying the industry.nullable
- subSectorCodestringoptionalCode identifying the sub-sector.nullable
- nicCodestringoptionalNational Industrial Classification (NIC) code.nullable
- activitystringoptionalType of business activity performed.nullable
- enterpriseTypearray<object>optionalList of enterprise type classifications over the years.nullable
Each item: 3 fields
- classificationYearstringoptionalYear for which the enterprise was classified.nullable
- enterpriseTypestringoptionalType of enterprise classification (e.g., Micro, Small, Medium).nullable
- classificationDatestringoptionalDate when the enterprise classification was assigned.nullable
- typeOfEnterprisestringoptionalThe resolved type of enterprise (e.g., Micro, Small, Medium) from the latest/current classification record.nullable
- pdfDatastringoptionalBase64-encoded PDF data of the Udyam registration certificate.nullable
- messagesarray<string>optionalNo description.nullable
- request_idstringoptionalNo description.nullable
- isBillablebooleanoptionalWhether this request was charged: true if it was, false if not. Errors always show false. Flows that finish later (ITR Fetch, SHCIL eStamp, DigiLocker, eSign) show false here, because the charge is made when the result is ready. eSign charges each signer when they complete signing. DigiLocker deducts the credit when the link is created and refunds it automatically if the link expires before the user completes it.
400Bad Request
- dataobjectoptionalNo description.
- messagesarray<string>optionalNo description.nullable
- request_idstringoptionalNo description.nullable
- successbooleanoptionalNo description.default false
- messagestringoptionalNo description.nullabledefault XXXXX
- isBillablebooleanoptionalNo description.
- statusCodeinteger (int32)optionalNo description.default 400
401Unauthorized
- dataobjectoptionalNo description.
- messagesarray<string>optionalNo description.nullable
- request_idstringoptionalNo description.nullable
- successbooleanoptionalNo description.default false
- messagestringoptionalNo description.nullabledefault XXXXX
- isBillablebooleanoptionalNo description.
- statusCodeinteger (int32)optionalNo description.default 401
500Internal Server Error
- dataobjectoptionalNo description.
- messagesarray<string>optionalNo description.nullable
- request_idstringoptionalNo description.nullable
- successbooleanoptionalNo description.default false
- messagestringoptionalNo description.nullabledefault XXXXX
- isBillablebooleanoptionalNo description.
- statusCodeinteger (int32)optionalNo description.default 500