--- agentTools: projectIndex: https://docs.decentro.tech/llms.txt --- # Business Verification Decentro's Verification Services encompasses all types of KYB requirements. Broadly, the services include the following: ![](https://files.readme.io/666ddeb647c0e7db86bba96e8ec2a03e783b68f7d88707f38f21e9e94a3e3cc9-image.png) 1. **Validate API:** Validate Business Documents using the Validate API 2. **Udyam Suite:** 1. **Udyam Fetch:** Fetch Udyam using the SME's Mobile and an OTP 2. **Udyam HyperStream:** Search and Validate Udyam using a single Udyam Hyperstream API 3. **Shop Establishment API:** Validate Shop Establishment details via the Registration Number. 4. **KYB UIStreams:** UI-based solutions to onboard businesses more securely and seamlessly. If you are interested in this product, please reach out to us at . # 1. Validate API Businesses can integrate with Decentro to verify the ID number of their customers or extract information from a public KYC ID. The major benefit of this offering is that customers do not have to upload or share any document images, yet the business can seamlessly onboard customers with very few hassles. > 😁 Regex Builder > > Developers can refer to this **[page](https://docs.decentro.tech/page/validation-regexes-master)** to build regex-checks that is based on the same checks Decentro performs before validating a document number from a government repository. This will help avoid uneccessary validation errors caused by invalid inputs from users. ## Supported Documents Our Document Verification API supports a good number of widely used documents like PAN, RC, GSTIN, CIN, etc. Below is the list of all documents that can verified using Decentro's Document Verification API: | Supported Documents | Description | | :------------------ | :------------------------------------------------------------------------------------------------------------------------------ | | PAN | A 10-character alphanumeric PAN number | | GSTIN | A 15-character GSTIN number | | CIN | Corporate Identification Number provided by MCA | | DIN | Director Identification Number (DIN) | | Udyam | Another unique registration number for Micro, Small, and Medium Enterprises (MSMEs) is provided by the Indian Ministry of MSMEs | | Udyog Aadhaar | 12-digit unique identification number provided by the Indian Ministry of MSMEs | | FLLPIN | Foreign Limited Liability Partnership Identification Number issued to any foreign organization incorporated as an LLP in India | | LLPIN | Limited Liability Partnership Identification number issued to any organization incorporated as an LLP in India | | FCRN | 6-character Foreign Company Registration Number | | FSSAI | The registration number provided by the Food Safety and Standards Authority of India | > 📘 Document Type Enumeration Standardized > > In the request body, "document\_type" parameter will only consider capital letters & underscore. > > The special character's not allowed -!@#$%^&\*()\~{}|<>,.:;"'?/+= > > Accepted Enumeration Examples - > > 1. PAN > 2. PAN\_DETAILED > > Not Accepted Enumeration Examples - > > 1. pan > 2. PAN-DETAILED ### 1. PAN PAN Stands for **Permanent Account Number** and it is a ten-digit alphanumeric number issued by the Income Tax Department of India. There are two types of PAN cards - | Individual PAN | Business PAN | | :--------------------------------- | :--------------------------------- | | A ten-digit alphanumeric ID number | A ten-digit alphanumeric ID number | | It belongs to a person | It belongs to a business | ```json Request - Business PAN { "reference_id": "Business PAN", "document_type": "PAN", "id_number": "XXXXXXXXXX", "consent": "Y", "consent_purpose": "Checking Business PAN details" } ``` ```json Response - Business PAN { "kycStatus": "SUCCESS", "status": "SUCCESS", "message": "KYC Details for PAN retrieved successfully", "kycResult": { "idNumber": "ABCDE12345", "idStatus": "VALID", "name": "AMAZON SELLER SERVICES PRIVATE LIMITED" }, "responseKey": "success_pan", "responseCode": "S00000", "requestTimestamp": "2020-07-24 21:25:20.778016 IST (GMT +0530)", "responseTimestamp": "2020-07-24 21:25:21.991470 IST (GMT +0530)", "decentroTxnId": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXX" } ``` > 😃 PAN Detailed - Individual and Business PAN > > Decentro has the feature to provide detailed information for both the PANs by passing ***PAN-Detailed*** in the **document\_type** parameter in the request body > 👍 Additional Configurations in the `PAN_DETAILED` Document Type > > Decentro also provides additional information in the `PAN_DETAILED` response such as: > > * Father Name > * Email > * Gender > * DOB > * Mobile Number > > Please reach out to our support team if you'd like to explore this configuration of the `PAN_DETAILED` document type. ```json Sample Request - PAN Detailed { "reference_id": "Fetching PAN-Detailed", "document_type": "PAN_DETAILED", "id_number": "XXXXXXXXXX", "consent": "Y", "consent_purpose": "To Fetch PAN-Detailed" } ``` ```json Sample Response - PAN Detailed { "referenceId": "Fetching PAN-Detailed", "kycStatus": "SUCCESS", "status": "SUCCESS", "message": "KYC Details for PAN retrieved successfully", "kycResult": { "idNumber": "XXXXXXXXXX", "idStatus": "VALID", "panStatus": "VALID", "lastName": "PRIVATE LIMITED", "firstName": "AMAZON SELLER SERVICES", "fullName": "AMAZON SELLER SERVICES PRIVATE LIMITED", "idHolderTitle": "M/S", "idLastUpdated": "20/04/2021", "aadhaarSeedingStatus": "Successful" }, "responseKey": "success_pan", "responseCode": "S00000", "requestTimestamp": "2020-07-24 21:25:20.778016 IST (GMT +0530)", "responseTimestamp": "2020-07-24 21:25:21.991470 IST (GMT +0530)", "decentroTxnId": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXX" } ``` ### 2. GSTIN GSTIN stands for **Goods and Services Tax Identification Number**. It is a unique 15-digit number assigned to business entities like dealers, suppliers, etc, and is registered under the GST regime. ```json Request { "reference_id": "GSTIN Document Verification", "document_type": "GSTIN", "id_number": "XXXXXXXXXXX", "consent": "Y", "consent_purpose": "To verify GSTIN document" } ``` ```json Response { "kycStatus": "SUCCESS", "status": "SUCCESS", "message": "KYC Details for GSTIN retrived successfully.", "kycResult": { "gstin": "XXXXXXXXXXXXXX", "legalName": "XXXXXXXXXXXXXXXXXXXX", "stateJurisdiction": "LGSTO 045 - Bengaluru", "centralJurisdiction": "RANGE-AED2", "centralJurisdictionCode": "YT0201", "constitutionOfBusiness": "Private Limited Company", "taxpayerType": "Regular", "natureOfBusiness": [ "Export", "Supplier of Services", "Import" ], "natureOfCoreBusinessActivity": "Service Provider and Others", "gstnStatus": "Active", "tradeName": "XXXXXXXXXXXXXXXXX", "registrationDate": "04/09/2020", "principalPlaceOfBusiness": "Indiranagar, Bengaluru, Bengaluru Urban, Karnataka, 560038", "pan": "XXXXXXXXXX", "registrationType": "NORMAL COMPOSITE CASUAL" }, "responseKey": "success_gstin", "responseCode": "S00000", "requestTimestamp": "2024-06-09 17:42:21.078532 IST (GMT +0530)", "responseTimestamp": "2024-06-09 17:42:22.027391 IST (GMT +0530)", "decentroTxnId": "XXXXXXXXXX" } ``` > 😃 GSTIN Detailed > > Decentro has the feature to provide detailed information for GSTIN documents by passing ***GSTIN-Detailed*** in the **document\_type** parameter in the request body ```json Request { "reference_id": "GSTIN-Detailed Document Verification", "document_type": "GSTIN_DETAILED", "id_number": "XXXXXXXXXXX", "consent": "Y", "consent_purpose": "To verify GSTIN document" } ``` ```json Response { "kycStatus": "******", "status": "******", "message": "***********************************************", "kycResult": { "gstin": "*******************", "legalName": "*******************************", "stateJurisdiction": "***********************", "centralJurisdiction": "************", "centralJurisdictionCode": "******", "constitutionOfBusiness": "***********************", "taxpayerType": "*******", "natureOfBusiness": [ "******", "*******************", "******" ], "natureOfCoreBusinessActivity": "*****************************", "annualAggregateTurnover": "**********", "gstnStatus": "******", "tradeName": "*******************************", "registrationDate": "**********", "principalPlaceOfBusiness": "********************************************", "pan": "***********", "registrationType": "****************************", "businessDetails": [ { "hsn": "******", "type": "********", "description": "*******************************************************" } ], "filingStatus": [ { "filingYear": "*********", "filingPeriod": "*****", "filingMethod": "******", "filingDate": "**********", "filingGstType": "******", "filingAnnualReturn": "**", "filingStatus": "*****" } ], "cinData": { "charges": [], "directors": [ { "endDate": "**", "dinOrPan": "********", "beginDate": "**********", "name": "************" }, { "endDate": "**", "dinOrPan": "********", "beginDate": "**********", "name": "*******************************" } ], "companyMasterData": { "companyCategory": "*******************************", "emailId": "*****************", "classOfCompany": "******", "numberOfMembersApplicableInCaseOfCompanyWithoutShareCapital": "**", "addressOtherThanRegisteredOfficeWhereAllOrAnyBooksOfAccountAndPapersAreMaintained": "**", "dateOfLastAgm": "**********", "registeredAddress": "****************************************************************", "registrationNumber": "*******", "paidUpCapitalInInr": "*******", "whetherListedOrNot": "********", "suspendedAtStockExchange": "**", "cin": "********************", "companySubcategory": "******************", "authorisedCapitalInInr": "********", "companyStatusForEFiling": "******", "rocCode": "*********", "dateOfBalanceSheet": "**********", "dateOfIncorporation": "**********", "companyName": "*******************************", "activeCompliance": "**", "mainDivisionOfBusinessActivityToBeCarriedOutInIndia": "**", "previousFircompanyDetailifApplicable": "**", "numberOfDesignatedPartners": "**", "totalObligationOfContribution": "*", "descriptionOfMainDivision": "*********************************************************", "numberOfPartners": "**" } }, "pdf": "********************************************" }, "responseKey": "*************", "responseCode": "******", "requestTimestamp": "*****************************************", "responseTimestamp": "*****************************************", "decentroTxnId": "*************************************" } ``` The following is a list of response parameters along with their meaning: | Parameter Name | Description | | ------------------------------------- | ------------------------------------------------------------------------------------------------------ | | `apiStatus` | Indicates the status of the API request. | | `status` | Indicates the overall status of the operation. | | `message` | A descriptive message accompanying the response, providing information about the outcome. | | `kycResult` | A JSON object containing advanced KYC details retrieved for the GSTIN. | | - `primaryBusinessContact` | Details about the primary business contact, including address, nature of business, etc. | | - `address` | Address of the primary business contact. | | - `additionalAddress` | Additional address details of the primary business contact. | | - `natureOfBusinessAtAddress` | Nature of business at the primary business contact's address. | | - `lastUpdatedDate` | Date when the information was last updated. | | - `stateJurisdiction` | State jurisdiction details for the GSTIN. | | - `taxpayerType` | Type of taxpayer (e.g., Regular, Composition). | | - `registrationDate` | Date of registration for the GSTIN. | | - `constitutionOfBusiness` | Constitution of the business (e.g., Private Limited Company, Partnership, etc.). | | - `currentStatusOfRegistration` | Current status of the GST registration (e.g., Active, Inactive). | | - `tradeName` | Trade name associated with the GSTIN. | | - `gstin` | Goods and Services Taxpayer Identification Number (GSTIN). | | - `directors` | List of directors associated with the business. | | - `additionalPlacesOfBusinessInState` | Additional places of business within the state, including address, nature of business, etc. | | - `businessDetails` | Details about the business, including HSN code and service details. | | - `legalName` | Legal name of the business. | | - `natureOfBusiness` | Nature of business activities associated with the business. | | - `centralJurisdiction` | Central jurisdiction details for the GSTIN. | | - `cxdt` | Central excise registration details. | | - `annualAggregateTurnover` | Annual aggregate turnover for the GSTIN ("unavailable" if the data is not available) | | - `mandatoryEInvoicing` | Indicates whether e-invoicing is mandatory for the GSTIN. | | - `grossTotalIncome` | Gross total income of the business. | | - `grossTotalIncomeFinancialYear` | The financial year for the gross total income. | | - `isFieldVisitConducted` | Indicates whether a field visit was conducted. | | - `pan` | Permanent Account Number (PAN) associated with the business. | | - `filingStatus` | Details about filing status, including year, month, method, date, GST type, annual return, and status. | | - `filingYear` | Year of filing. | | - `filingForMonth` | Month for which filing was done. | | - `filingMethod` | Method of filing (e.g., ONLINE, OFFLINE). | | - `filingDate` | Date of filing. | | - `filingGstType` | Type of GST filing (e.g., GSTR1, GSTR3B). | | - `filingAnnualReturn` | Annual return filing status. | | - `filingStatus` | Status of filing (e.g., Filed, Pending). | | `responseKey` | A key indicating the success of the GSTIN retrieval request. | | `responseCode` | A code indicating the outcome of the request. | | `requestTimestamp` | Timestamp when the request was made. | | `responseTimestamp` | Timestamp when the response was received. | | `decentroTxnId` | The transaction ID generated by Decentro for tracking purposes. | > 👍 Downloadable PDF Reports > > The `GSTIN_DETAILED` document type of the Validate API now has an additional optional parameter `generate_pdf`. This will return a downloadable link to the PDF file containing the data returned by the `GSTIN_DETAILED` API. > > Albeit the link is sent to you, you can also generate the link on the fly if needed. You can download the file a `https://in.decentro.tech/v2/common/download/.pdf` > > Please note, in order for the download to work, `client_id` and `client_secret` must be present in the headers. ### 3. CIN CIN stands for **Corporate Identification Number**. It is a unique 21 digit alphanumeric number issued to companies that have been registered in India. Private Limited Companies are also included in CIN registration. ```json Request { "reference_id": "CIN Document Verification", "document_type": "CIN", "id_number": "XXXXXXXXXXX", "consent": "Y", "consent_purpose": "To verify CIN document" } ``` ```json Response { "status": "******", "kycStatus": "******", "message": "*** ******* *** *** ******** ***********.", "kycResult": { "companyData": { "cIN": "**********************", "company": "*******************************", "companyType": "*******", "companyOrigin": "******", "registrationNumber": "******", "dateOfIncorporation": "*********", "emailAddress": "*******************", "whetherListedOrNot": "*", "companyCategory": "**************************", "companySubcategory": "*********************", "classOfCompany": "*******", "authorisedCapital": "*******", "paidUpCapital": "*******", "numberOfMembers": "", "dateOfLastAGM": "*********", "strikeOffAmalgamatedTransferredDate": "", "llpStatus": "******", "statusUnderCIRP": "", "numberOfPartners": "", "numberOfDesignatedPartners": "", "previousFirmCompanyDetails": "", "totalObligationOfContribution": "*", "mainDivision": "**", "mainDivisionDescription": "***************************************", "statementDate": "", "bSDefaulter2Yrs": "", "bSDefaulter3Yrs": "", "aRDefaulter2Yrs": "", "aRDefaulter3Yrs": "", "suspendedAtStockExchange": "", "rocName": "*** *****", "shareCapitalFlag": "*", "maximumNumberOfMembers": "", "subscribedCapital": "*******", "rdName": "** *****", "rdRegion": "******** ******", "balanceSheetDate": "*********", "inc22Aflag": "" }, "directorData": [ { "dIN": "********", "pAN": "**********", "dateOfAppointment": "*********", "directorDisqualified": "*", "firstName": "*****", "middleName": "", "lastName": "******" }, { "dIN": "********", "pAN": "**********", "dateOfAppointment": "*********", "directorDisqualified": "*", "firstName": "******", "middleName": "******", "lastName": "*********" }, { "dIN": "********", "pAN": "**********", "dateOfAppointment": "*********", "directorDisqualified": "*", "firstName": "*******", "middleName": "", "lastName": "******" }, { "dIN": "********", "pAN": "", "dateOfAppointment": "*********", "directorDisqualified": "*", "firstName": "*****", "middleName": "", "lastName": "******" }, { "dIN": "********", "pAN": "**********", "dateOfAppointment": "*********", "directorDisqualified": "*", "firstName": "*******", "middleName": "", "lastName": "******" } ] }, "responseKey": "************", "responseCode": "*****", "requestTimestamp": "********************************", "responseTimestamp": "********************************", "decentroTxnId": "****************************" } ``` ### 4. FSSAI Card FSSAI stands for **Food Safety and Standards Authority of India**. ```json Request { "reference_id": "FSSAI Document Verification", "document_type": "FSSAI", "id_number": "XXXXXXXXXXX", "consent": "Y", "consent_purpose": "To verify FSSAI document" } ``` ```json Response { "kycStatus": "SUCCESS", "kycResult": { "idNumber": "11111111111111", "licenseType": "REGISTRATION", "entityName": "NAME", "status": "ACTIVE", "premissesAddress": { "district": "", "address": "Some Address Line", "state": "WEST BENGAL", "pincode": "XXXXXX" }, "products": [ { "slNo": "2", "foodProductCategory": "02 - Product Category Name" }, { "slNo": "13", "foodProductCategory": "13 - Product Category Name" } ], "address": { "district": [ "EAST MIDNAPORE" ], "state": [ [ "WEST BENGAL", "WB" ] ], "city": [ "KHANJANCHAK" ], "pincode": "XXXXXX", "country": [ "IN", "IND", "INDIA" ], "addressLine": "Some Address Line" } }, "responseKey": "success_fssai", "responseCode": "S00000", "requestTimestamp": "2023-01-13 14:57:22.932451 IST (GMT +0530)", "responseTimestamp": "2023-01-13 14:57:23.866098 IST (GMT +0530)", "decentroTxnId": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXX" } ``` | Parameter Name | Description | | ----------------------- | ----------------------------------------------------------------------------------------------------------- | | `kycStatus` | Indicates the status of the Know Your Customer (KYC) process. | | `kycResult` | A JSON object containing detailed KYC information. | | - `idNumber` | Identification number associated with the entity. | | - `licenseType` | Type of license (e.g., REGISTRATION). | | - `entityName` | Name of the entity. | | - `status` | Status of the entity (e.g., ACTIVE). | | - `premissesAddress` | Address details of the premises, including district, address, state, and pincode. | | - `district` | District of the premises address. | | - `address` | Address line of the premises. | | - `state` | State of the premises address. | | - `pincode` | Pincode of the premises address. | | - `products` | List of products associated with the entity, including serial number and food product category. | | - `slNo` | Serial number of the product. | | - `foodProductCategory` | Category of the food product. | | - `address` | Address details of the entity, including district, state, city, pincode, country, and address line. | | - `district` | District of the entity's address. | | - `state` | State of the entity's address. | | - `city` | City of the entity's address. | | - `pincode` | Pincode of the entity's address. | | - `country` | Country code of the entity's address. | | - `addressLine` | Address line of the entity. | | `responseKey` | A key indicating the success of the FSSAI (Food Safety and Standards Authority of India) retrieval request. | | `responseCode` | A code indicating the outcome of the request. | | `requestTimestamp` | Timestamp when the request was made. | | `responseTimestamp` | Timestamp when the response was received. | | `decentroTxnId` | The transaction ID generated by Decentro for tracking purposes. | ### 5. Udyog Aadhaar It is a 12-digit unique identification number provided by the Indian Ministry of Micro, Small and Medium Enterprises (**MSMEs**). ```json Request { "reference_id": "Udyog Aadhaar Document Verification", "document_type": "UDYOG_AADHAAR", "id_number": "XXXXXXXXXXX", "consent": "Y", "consent_purpose": "To verify Udyog Aadhaar document" } ``` ```json Response { "status": "SUCCESS", "kycStatus": "SUCCESS", "message": "KYC Details for Udyog Aadhaar retrieved successfully.", "kycResult": { "uamNumber": "XXXXXXXXX", "enterpriseName": "GARIMA ONLINE AND PHOTOCOPY", "majorActivity": "SERVICES", "socialCategory": "OBC", "enterpriseType": "MICRO", "mobile": "89*****168", "email": "NE******14@GMAIL.COM", "dateOfCommencement": "22/10/2018", "dicName": "VIDISHA", "state": "MADHYA PRADESH", "appliedDate": "12/12/2018", "modifiedDate": "N/A", "address": { "serialNumber": "1", "flatDoorBlockNumber": "XXXXXXXXX", "nameOfPremisesBuildingVillage": "XXXXXXXXX", "roadStreetLane": "XXXXXXXXX", "areaLocality": "XXXXXXXXX", "city": "XXXXXXXXX", "pin": "XXXXXXXXX", "state": "MADHYA PRADESH", "district": "XXXXXXXXX" }, "expiryDate": "30/06/2022", "status": "VALID", "nic_2Digit": "63-INFORMATION SERVICE ACTIVITIES", "nic_4Digit": "6312-WEB PORTALS", "nic_5Digit": "63121-OPERATION OF WEB SITES THAT USE A SEARCH ENGINE TO GENERATE AND MAINTAIN EXTENSIVE DATABASES OF INTERNET ADDRESSES AND CONTENT IN AN EASILY SEARCHABLE FORMAT" }, "responseKey": "success_udyog_aadhaar", "responseCode": "S00000", "requestTimestamp": "XXXXXXXXX", "responseTimestamp": "XXXXXXXXX", "decentroTxnId": "XXXXXXXXX" } ``` | Parameter Name | Description | | ---------------------- | --------------------------------------------------------------------------------------------- | | `kycStatus` | Indicates the status of the Know Your Customer (KYC) process. | | `kycResult` | A JSON object containing detailed KYC information. | | - `uamNumber` | Udyog Aadhaar Memorandum (UAM) number associated with the enterprise. | | - `enterpriseName` | Name of the enterprise. | | - `majorActivity` | The primary activity of the enterprise. | | - `socialCategory` | Social category of the enterprise. | | - `enterpriseType` | Type of enterprise. | | - `dateOfCommencement` | Date of commencement of business operations. | | - `district` | District where the enterprise is located. | | - `state` | State where the enterprise is located. | | - `appliedDate` | Date when the KYC information was applied. | | - `modifiedDate` | Date when the KYC information was last modified. | | - `expiryDate` | Expiry date of the KYC information. | | - `nic_2Digit` | 2-digit National Industrial Classification (NIC) code representing the enterprise's activity. | | - `nic_4Digit` | 4-digit NIC code representing the enterprise's activity. | | - `nic_5Digit` | 5-digit NIC code representing the enterprise's activity. | | - `status` | Status of the enterprise (e.g., ACTIVE). | | `responseKey` | A key indicating the success of the Udyog Aadhaar retrieval request. | | `responseCode` | A code indicating the outcome of the request. | | `requestTimestamp` | Timestamp when the request was made. | | `responseTimestamp` | Timestamp when the response was received. | | `decentroTxnId` | The transaction ID is generated by Decentro for tracking purposes. | ### 6. Udyam Number It is a unique registration mechanism for Micro, Small and Medium Enterprises (MSMEs). It is mandatory for **MSMEs** to get their Udyam Aadhaar number. ```json Request { "reference_id": "Udyam Document Verification", "document_type": "UDYAM", "id_number": "XXXXXXXXXXX", "consent": "Y", "consent_purpose": "To verify Udyam document" } ``` ```json Response { "decentroTxnId": "DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "status": "SUCCESS", "responseCode": "S00000", "message": "Successfully fetched details for the given Udyam number.", "data": { "udyamNumber": "UDYAM-AA-00-0000000", "enterpriseName": "M/S XXXXX XXXXX", "organisationType": "Private Limited Company", "majorActivity": "Services", "gender": "Male", "socialCategory": "General", "incorporationDate": "DD/MM/YYYY", "commencementDate": "DD/MM/YYYY", "enterpriseOfficialAddress": { "flat": "XXXX", "building": "XXXXXXXXXXXXXXXXXXX", "village": "XXXXXXXXXXXX", "block": "-", "street": "XXXXXXXXXXXXXXXXXXX", "city": "XXXXXXXXXXXX", "state": "XXXXXXXXXXXX", "district": "BENGALURU (URBAN)", "mobile": "XX*****XXX", "email": "XXXXXXXXXXXXXXXXX" }, "dic": "BANGALORE (URBAN)", "msmeDfo": "BANGALORE", "udyamRegistrationDate": "DD/MM/YYYY", "enterpriseType": { "serialNumber": "1", "dataYear": "2020-21", "classificationYear": "2022-23", "enterpriseType": "Micro", "classificationDate": "DD/MM/YYYY" }, "unitLocationDetails": { "serialNumber": "1", "unitName": "XXXXXXXXXXXXXXXXX", "flat": "XXXX", "building": "XXXXXXXXXXXXXXXXXXX", "village": "XXXXXXXXXXXXXXXXXXX", "block": "", "road": "XXXXXXXXXXXXXXXXXXX", "city": "XXXXXXXXXXXX", "pin": "XXXXXX", "state": "KARNATAKA", "district": "BENGALURU (URBAN)" }, "nationalIndustryClassificationCode": { "serialNumber": "1", "nic2Digit": "XX - Computer programming, consultancy and related activities", "nic4Digit": "XXXX - Other information technology and computer service activities", "nic5Digit": "XXXXX - Other information technology and computer service activities n.e.c", "activity": "Services", "date": "DD/MM/YYYY" } }, "responseKey": "success_udyam" } ``` > 👍 Optional `generate_pdf` key > > Now, you can download the Udyam Certificate for valid Udyam numbers by passing the optional `generate_pdf` key as `true`. Certificate File validity: 7 days > > Refer to the Download File API [here](https://docs.decentro.tech/reference/kyc-and-onboarding-api-reference-utilities-download-pdf-files) The following is a table defining each parameter in the given response body: | Parameter Name | Description | | -------------------------------------- | ------------------------------------------------------------------------------------------------ | | `decentroTxnId` | The transaction ID generated by Decentro for tracking purposes. | | `status` | Indicates the status of the request, whether it was successful or not. | | `responseCode` | A code indicating the outcome of the request. | | `message` | A descriptive message accompanying the response, providing information about the outcome. | | `data` | A JSON object containing detailed information about the enterprise and its registration details. | | - `udyamNumber` | The unique Udyam registration number is assigned to the enterprise. | | - `enterpriseName` | The name of the enterprise. | | - `organisationType` | The type of organization, such as Private Limited Company, Sole Proprietorship, etc. | | - `majorActivity` | The primary activity of the enterprise. | | - `gender` | Gender of the enterprise owner or representative. | | - `socialCategory` | Social category of the enterprise owner or representative. | | - `incorporationDate` | Date of incorporation of the enterprise. | | - `commencementDate` | Date of commencement of business operations. | | - `enterpriseOfficialAddress` | Official address details of the enterprise, including flat, building, village, city, etc. | | - `dic` | District Industrial Center where the enterprise is registered. | | - `msmeDfo` | MSME Development Forum associated with the enterprise. | | - `udyamRegistrationDate` | Date of Udyam registration. | | - `enterpriseType` | Details about the enterprise type, including classification and registration dates. | | - `serialNumber` | Serial number assigned to the enterprise type. | | - `dataYear` | Year of data for the enterprise type classification. | | - `classificationYear` | Year of classification of the enterprise type. | | - `enterpriseType` | Type of enterprise (e.g., Micro, Small, Medium). | | - `classificationDate` | Date of classification of the enterprise type. | | - unitLocationDetails | Details about the location of the enterprise unit. | | - `serialNumber` | Serial number assigned to the unit location details. | | - `unitName` | Name of the enterprise unit. | | - `flat` | Flat number of the unit. | | - `building` | Building name of the unit. | | - `village` | Village where the unit is located. | | - `block` | Block where the unit is located. | | - `road` | Road where the unit is located. | | - `city` | City where the unit is located. | | - `pin` | PIN code of the unit location. | | - `state` | State where the unit is located. | | - `district` | District where the unit is located. | | - `nationalIndustryClassificationCode` | Details about the National Industry Classification (NIC) code of the enterprise's activity. | | - `serialNumber` | Serial number assigned to the NIC code details. | | - `nic2Digit` | 2-digit NIC code representing the industry classification. | | - `nic4Digit` | 4-digit NIC code representing the industry classification. | | - `nic5Digit` | 5-digit NIC code representing the industry classification. | | - `activity` | Activity associated with the NIC code. | | - `date` | Date of NIC code assignment. | | `responseKey` | A key indicating the success of the Udyam registration request. | ### 7. FLLPIN ```json Request { "reference_id": "FLLPIN Document Verification", "document_type": "FLLPIN", "id_number": "XXXXXXXXXXX", "consent": "Y", "consent_purpose": "To verify FLLPIN document" } ``` ```json Response { "status": "SUCCESS", "kycStatus": "SUCCESS", "message": "KYC Details for FLLPIN retrieved successfully.", "kycResult": { "foreignCompanyMasterData": { "emailId": "xxxxx@xx.com", "foreignCompanyWithShareCapital": "NA", "registeredAddress": "XXXXXXXXXXXXXXXXX", "typeOfOffice": "Branch Office", "dateOfIncorporation": "24/04/2007", "countryOfIncorporation": "South Korea", "companyName": "XXXXXXXXXXX", "companyStatus": "Not Available for e-filing", "details": "NA", "fcrn ": "XXXXXX", "descriptionOfMainDivision": "Computer and related activities", "mainDivisionOfBusinessActivityToBeCarriedOutInIndia": "72" }, "charges": [], "directors": [ { "endDate": "NA", "surrenderedDin": "NA", "dinOrPan": "XXXXXXXXXX", "beginDate": "06/08/2007", "name": "XXXXXXXXX" } ] }, "responseKey": "success_fllpin", "responseCode": "S00000", "requestTimestamp": "2023-08-30 18:07:10.447335 IST (GMT +0530)", "responseTimestamp": "2023-08-30 18:07:18.567955 IST (GMT +0530)", "decentroTxnId": "DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" } ``` ### 8. DIN DIN stands for **Directors Identification Number**. It is a unique identification number allotted by the Central Government to a person intended to be a Director of a company. ```json Request { "reference_id": "DIN Document Verification", "document_type": "DIN", "id_number": "XXXXXXXXXXX", "consent": "Y", "consent_purpose": "To verify DIN document" } ``` ```json Response { "status": "******", "kycStatus": "******", "message": "*** ******* *** *** ******** ***********.", "kycResult": { "directorData": [ { "din": "********", "directorDisqualified": "*", "disqualificationRemovalDate": "", "firstName": "*******", "middleName": "", "lastName": "******", "status": "*******", "dinSurrenderDate": "", "educationalQualification": "****", "birthPlace": "********************", "drivingLicenseNumber": "", "mobileNumber": "************", "directorDeathDate": "", "votersIdNumber": "", "durationofStay": "", "fathersFirstName": "******", "authorizedRepType": "", "membershipNumber": "", "nationality": "*****", "disqualificationSection": "", "gender": "****", "dinAllocationDate": "*********", "occupationType": "", "kmpFlag": "", "othersEducationalQualification": "", "disqualificationDate": "", "disqualificationReason": "", "verificationStatus": "", "opcFlag": "", "sameAddressFlag": "", "fathersLastName": "******", "dob": "*********", "fathersMiddleName": "", "surrenderDeactivationReason": "", "pan": "**********", "oidFlag": "*", "passportNumber": "", "residentOfIndia": "*", "personalContact": "*", "aadhaarNumber": "************", "directorFlag": "*", "emailAddress": "***********************", "personType": "*********", "areaOfOccupation": "**************", "citizenOfIndia": "*", "occupation": "**************", "opcType": "", "otherOccupation": "", "companyData": [ { "ucin": "**********************", "din": "********", "cin_LLPIN": "**********************", "nameOfTheCompany": "*******************************", "companyId": "*******" }, { "ucin": "**********************", "din": "********", "cin_LLPIN": "**********************", "nameOfTheCompany": "***********************************************", "companyId": "*******" } ], "createdOn": "********************", "migrationDate": "********************", "updatedOn": "********************", "migrationFlag": "*", "accountId": "" } ] }, "responseKey": "***********", "responseCode": "*****", "requestTimestamp": "********************************", "responseTimestamp": "********************************", "decentroTxnId": "****************************" } ``` ### 9. LLPIN LLPIN stands for **Limited Liability Partnership Identification Number**. ```json Request { "reference_id": "LLPIN Document Verification", "document_type": "LLPIN", "id_number": "XXXXXXXXXXX", "consent": "Y", "consent_purpose": "To verify LLPIN document" } ``` ```json Response { "status": "SUCCESS", "kycStatus": "SUCCESS", "message": "KYC Details for LLPIN retrieved successfully.", "kycResult": { "charges": [], "directors": [ { "endDate": "NA", "surrenderedDin": "NO", "dinOrPan": "XXXXXXX", "beginDate": "24/03/2015", "name": "XXXXXXXXXXXXX" }, { "endDate": "NA", "surrenderedDin": "NO", "dinOrPan": "XXXXXXX", "beginDate": "24/03/2015", "name": "XXXXXXXXXXXXX" } ], "llpMasterData": { "emailId": "xxxxxxxxxx@xx.in", "registeredAddress": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "dateOfLastFinancialYearEndDateForWhichAnnualReturnFiled": "NA", "dateOfLastFinancialYearEndDateForWhichStatementOfAccountsAndSolvencyFiled": "NA", "mainDivisionOfBusinessActivityToBeCarriedOutInIndia": "74", "previousFircompanyDetailifApplicable": "NA", "rocCode": "RoC-Mumbai", "numberOfDesignatedPartners": "2", "dateOfIncorporation": "24/03/2015", "llpName": "XXXXXXXXXX LLP", "totalObligationOfContribution": "110000", "llpin ": "XXXXXXX", "llpStatus": "Active", "descriptionOfMainDivision": "Other Business Activities", "numberOfPartners": "0" } }, "responseKey": "success_llpin", "responseCode": "S00000", "requestTimestamp": "2023-08-30 18:11:08.841061 IST (GMT +0530)", "responseTimestamp": "2023-08-30 18:11:16.167331 IST (GMT +0530)", "decentroTxnId": "DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" } ``` ### 10. FCRN FCRN stands for **Foreign Company Registration Number** and is a 6-digit number. ```json Request { "reference_id": "FCRN Document Verification", "document_type": "FCRN", "id_number": "XXXXXXXXXXX", "consent": "Y", "consent_purpose": "To verify FCRN document" } ``` ```json Response { "status": "SUCCESS", "kycStatus": "SUCCESS", "message": "KYC Details for FCRN retrieved successfully.", "kycResult": { "charges": [], "directors": [ { "endDate": "NA", "surrenderedDin": "NO", "dinOrPan": "XXXXXXXX", "beginDate": "24/03/2015", "name": "XXXXXXXX XXXXXXXX XXXXXXXX" }, { "endDate": "NA", "surrenderedDin": "NO", "dinOrPan": "XXXXXXXX", "beginDate": "24/03/2015", "name": "XXXXXXXX XXXXXXXX XXXXXXXX" } ], "llpMasterData": { "emailId": "XXXXXXXX@XX.in", "registeredAddress": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "dateOfLastFinancialYearEndDateForWhichAnnualReturnFiled": "NA", "dateOfLastFinancialYearEndDateForWhichStatementOfAccountsAndSolvencyFiled": "NA", "mainDivisionOfBusinessActivityToBeCarriedOutInIndia": "74", "previousFircompanyDetailifApplicable": "NA", "rocCode": "RoC-Mumbai", "numberOfDesignatedPartners": "2", "dateOfIncorporation": "24/03/2015", "llpName": "XXXXXXXX LLP", "totalObligationOfContribution": "110000", "llpin ": "XXXXXXX", "llpStatus": "Active", "descriptionOfMainDivision": "Other Business Activities", "numberOfPartners": "0" } }, "responseKey": "success_fcrn", "responseCode": "S00000", "requestTimestamp": "2023-08-30 18:20:20.856513 IST (GMT +0530)", "responseTimestamp": "2023-08-30 18:20:22.123674 IST (GMT +0530)", "decentroTxnId": "DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" } ``` *** # 2. Udyam Suite ## What is Udyam and why is it important? Udyam is a government registration system designed to provide a unique identification number (Udyam Number) to Micro, Small, and Medium Enterprises (MSMEs). It plays a critical role in promoting and supporting the growth of these enterprises by granting access to various government schemes, subsidies, and financial benefits. Udyam registration simplifies the process for MSMEs to avail loans, tax incentives, and market access, enabling them to scale their operations more efficiently. Additionally, the Udyam Number acts as a trusted business identity, which is important for enhancing credibility and improving opportunities for business partnerships and growth. ### Key Facts: 1. Udyam numbers can be generated in real-time. 2. Udyam numbers are unique to a PAN number. 3. A single mobile or Aadhaar number can be linked to multiple Udyam numbers. 4. Udyam numbers do not have any expiration. 5. Udyam documents do not segregate between the sole proprietor's name (legal name) and the name of the establishment. Either of those names can be provided as the "Udyam Name" of the document. Decentro's Udyam Suite offers a host of solutions for all your Udyam needs ## Fetch Udyam The **Fetch Udyam** provides a more confident and authenticated method to retrieve Udyam numbers and Udyam Certificates. By using the mobile number and an OTP, this API ensures that the correct Udyam data is retrieved from the registry, including the official certificate that verifies a business’s registration. * **Key Features**: * Utilizes OTP-based authentication for secure data retrieval. * Provide the Udyam number and the associated Udyam Certificate. * Ensures that only authorized parties can fetch this sensitive information. *** ## Udyam HyperStream The **Udyam HyperStream** is a comprehensive solution that combines search and validation in one unified endpoint. Instead of performing two separate actions—searching for Udyam details and then validating them—this API returns both the search results and associated Udyam details, including a PDF of the certificate, in a single response. This streamlines the process, making it efficient for platforms that need to quickly confirm Udyam's status. * **Key Features**: * Combines both search and validation processes into a single API call. * Returns Udyam details for up to 5 Udyam numbers at once. * Provides a downloadable PDF of the Udyam certificate as part of the response. *** # 3. Shop Establishment API ### **API Overview** The Shop Establishment API allows for the verification of shop establishment details based on a shop establishment ID. **Endpoint:** `/v2/kyc/identities/business-verification/shop-establishment` ```json Request { "reference_id": "50c10719-6abc-4d1e-8dd9-3a9f337a00e9", "consent": true, "purpose": "For verify a Shop using the Shop Establishment ID", "id_number": "UPSA46717513", "state_code": "UP", "category": "Shop" } ``` ```json Response { "decentroTxnId": "E0D4C2A3E2A74332815908E070E41AF8", "status": "SUCCESS", "responseCode": "S00000", "message": "Shop Establishment Details retrieved Successfully", "responseKey": "success_shop_establishment_details_found", "result": { "establishmentName": "ABC SERVICES", "registrationNumber": "UPSA00000001", "dateOfCommencement": "01/12/2000", "status": "", "expiryDate": "01/12/2000", "applicationType": "", "actName": "", "address": "01, PRAYAGRAJ, 211011", "acknowledgementNo": "", "estblishmentId": "", "certificateFile": "", "category": "", "renewalPosition": "", "previousRegistrationCertificate": "" }, "requestTimestamp": "2025-12-05 16:21:38.408632 IST (GMT +0530)", "responseTimestamp": "2025-12-05 16:21:38.705452 IST (GMT +0530)" } ``` > 👍 `category` key required for `state_code: MH` > > If the shop establishment belongs to MAHARASHTRA, i.e., the `state_code : MH`in that case the key`category` is mandatory. ### **State Codes:** The state code (`state_code`) must be one of the following: | Code | State Name | | ---- | ------------- | | UP | Uttar Pradesh | | KA | Karnataka | | JH | Jharkhand | | WB | West Bengal | If an invalid `state_code` is provided, the API will return the following error: ### **Supported values for `category`** * `SHOP I` * `COMMERCIAL II` * `RESTAURANT AND EATING HOUSE IV` * `RESIDENTIAL HOTEL III` * `THEATRE – PUBLIC AMUSEMENT V`