Business Verification
Decentro's Verification Services encompasses all types of KYB requirements. Broadly, the services include the following:
- Validate API: Validate Business Documents using the Validate API
- Udyam Suite:
- Mobile to Udyam: Search for a Udyam Number using just a Mobile number
- Udyam Fetch: Fetch Udyam using the SME's Mobile and an OTP
- Udyam Registration: Real-time Udyam Number Registration APIs
- Udyam HyperStream: Search and Validate Udyam using a single Udyam Hyperstream API
- Udyam Registration UIStream: UI-based flow to generate Udyam Numbers in real-time
- Shop Establishment API: Validate Shop Establishment details via the Registration Number.
- 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 [email protected].
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 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 -
- PAN
- PAN_DETAILED
Not Accepted Enumeration Examples -
- pan
- 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 |
{
"reference_id": "Business PAN",
"document_type": "PAN",
"id_number": "XXXXXXXXXX",
"consent": "Y",
"consent_purpose": "Checking Business PAN details"
}
{
"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 TypeDecentro also provides additional information in the
PAN_DETAILED
response such as:
- Father Name
- 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.
{
"reference_id": "Fetching PAN-Detailed",
"document_type": "PAN_DETAILED",
"id_number": "XXXXXXXXXX",
"consent": "Y",
"consent_purpose": "To Fetch 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.
{
"reference_id": "GSTIN Document Verification",
"document_type": "GSTIN",
"id_number": "XXXXXXXXXXX",
"consent": "Y",
"consent_purpose": "To verify GSTIN document"
}
{
"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
{
"reference_id": "GSTIN-Detailed Document Verification",
"document_type": "GSTIN_DETAILED",
"id_number": "XXXXXXXXXXX",
"consent": "Y",
"consent_purpose": "To verify GSTIN document"
}
{
"kycStatus": "******",
"status": "******",
"message": "***********************************************",
"kycResult": {
"gstin": "*******************",
"legalName": "*******************************",
"stateJurisdiction": "***********************",
"centralJurisdiction": "************",
"centralJurisdictionCode": "******",
"constitutionOfBusiness": "***********************",
"taxpayerType": "*******",
"natureOfBusiness": [
"******",
"*******************",
"******"
],
"natureOfCoreBusinessActivity": "*****************************",
"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. |
- 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 parametergenerate_pdf
. This will return a downloadable link to the PDF file containing the data returned by theGSTIN_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/<YOUR DECENTRO TRANSACTION ID>.pdf
Please note, in order for the download to work,
client_id
andclient_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.
{
"reference_id": "CIN Document Verification",
"document_type": "CIN",
"id_number": "XXXXXXXXXXX",
"consent": "Y",
"consent_purpose": "To verify CIN document"
}
{
"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.
{
"reference_id": "FSSAI Document Verification",
"document_type": "FSSAI",
"id_number": "XXXXXXXXXXX",
"consent": "Y",
"consent_purpose": "To verify FSSAI document"
}
{
"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).
{
"reference_id": "Udyog Aadhaar Document Verification",
"document_type": "UDYOG_AADHAAR",
"id_number": "XXXXXXXXXXX",
"consent": "Y",
"consent_purpose": "To verify Udyog Aadhaar document"
}
{
"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******[email protected]",
"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.
{
"reference_id": "Udyam Document Verification",
"document_type": "UDYAM",
"id_number": "XXXXXXXXXXX",
"consent": "Y",
"consent_purpose": "To verify Udyam document"
}
{
"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
keyNow, you can download the Udyam Certificate for valid Udyam numbers by passing the optional
generate_pdf
key astrue
.
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
{
"reference_id": "FLLPIN Document Verification",
"document_type": "FLLPIN",
"id_number": "XXXXXXXXXXX",
"consent": "Y",
"consent_purpose": "To verify FLLPIN document"
}
{
"status": "SUCCESS",
"kycStatus": "SUCCESS",
"message": "KYC Details for FLLPIN retrieved successfully.",
"kycResult": {
"foreignCompanyMasterData": {
"emailId": "[email protected]",
"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.
{
"reference_id": "DIN Document Verification",
"document_type": "DIN",
"id_number": "XXXXXXXXXXX",
"consent": "Y",
"consent_purpose": "To verify DIN document"
}
{
"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.
{
"reference_id": "LLPIN Document Verification",
"document_type": "LLPIN",
"id_number": "XXXXXXXXXXX",
"consent": "Y",
"consent_purpose": "To verify LLPIN document"
}
{
"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": "[email protected]",
"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.
{
"reference_id": "FCRN Document Verification",
"document_type": "FCRN",
"id_number": "XXXXXXXXXXX",
"consent": "Y",
"consent_purpose": "To verify FCRN document"
}
{
"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": "[email protected]",
"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:
- Udyam numbers can be generated in real-time.
- Udyam numbers are unique to a PAN number.
- A single mobile or Aadhaar number can be linked to multiple Udyam numbers.
- Udyam numbers do not have any expiration.
- 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
Search Udyam via Mobile
The Mobile to Udyam API provides all linked Udyam numbers and PAN numbers to the given input mobile number.
Key Features:
- Utilizes direct Mobile to Udyam linkage with 100% confidence
- It can be combined with the UDYAM FETCH Hyperstream to download certificates as well
- Ensures seamless and easy fetch of all Udyam without any OTP.
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 Registration
The Udyam Registration APIs offer businesses the ability to register for a Udyam number directly through your platform. This is particularly useful for businesses that do not yet have a Udyam number but need to obtain one to qualify for various benefits and schemes offered by the government for MSMEs (Micro, Small, and Medium Enterprises).
- Key Features:
- Simplifies the registration process by integrating it into your platform.
- Automates the entire Udyam registration process, removing the need for manual data entry.
- Ensures seamless user experience by keeping all operations within a single interface.
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 and other relevant information such as the state code and category (for Maharashtra).
Request
Endpoint: /v2/kyc/identities/business-verification/shop-establishment
Headers:
Key | Description | Example Value |
---|---|---|
client_id | Your unique client ID | xxxx |
client_secret | Your unique client secret | xxxxx |
module_secret | Unique secret for this API module | xxxx |
Content-Type | The content type of the request | application/json |
Body Parameters:
Key | Type | Description | Required | Example Value |
---|---|---|---|---|
reference_id | string | Unique reference ID for the request. | Yes | 4137c3a6-d7fa-4495-ae1e-c1c3f08057b4 |
consent | boolean | Customer consent for verifying shop establishment details. | Yes | true |
purpose | string | Purpose of the request. | Yes | For verify a Shop using the Shop Establishment ID |
id_number | string | Shop establishment ID number. | Yes | SCA/2020/14/135624 |
state_code | string | State code where the shop is registered. Must be one of the enumerations (listed below). | Yes | RJ |
category | string | Applicable only for Maharashtra (MH). One of the listed categories (Shop, Commercial, etc.). | No* | Commercial |
*
category
is required ifstate_code
isMH
. Otherwise, it is optional.
State Codes:
The state code (state_code
) must be one of the following:
Code | State Name |
---|---|
WB | West Bengal |
TS | Telangana |
UP | Uttar Pradesh |
RJ | Rajasthan |
HR | Haryana |
DL | Delhi |
MH | Maharashtra |
KR | Karnataka |
JR | Jharkhand |
MP | Madhya Pradesh |
JK | Jammu Kashmir |
If an invalid state_code
is provided, the API will return the following error:
Error Response for Invalid State Code:
{
"responseKey": "error_invalid_state_code",
"message": "The state_code value should be one of the following values: [ WB, TS, UP, RJ, DL, MH, KR, JR, MP, JK ]"
}
Response
Upon a successful request, the API will return the shop establishment details.
Response Keys:
Key | Type | Description | Example Value |
---|---|---|---|
decentroTxnId | string | Unique transaction ID generated for this request. | C566EBC6822C4D728FEED8A4C38484F5 |
status | string | Status of the request (e.g., SUCCESS , FAILED ). | SUCCESS |
responseCode | string | Code representing the result of the API request. | S00000 |
message | string | Message explaining the result. | Shop Establishment Details retrieved Successfully |
data | object | Object containing the shop establishment details. | (See below for detailed structure) |
responseKey | string | Key representing the success or error of the request. | success_shop_establishment_details_found |
Data Object:
Key | Type | Description | Example Value |
---|---|---|---|
essentials | object | Contains essential establishment information. | (See below for detailed structure) |
result | object | Detailed shop establishment result. | (See below for detailed structure) |
Essentials Object:
Key | Type | Description | Example Value |
---|---|---|---|
registrationNumber | string | Shop establishment registration number. | SCA/2020/14/135624 |
state | string | State where the shop is registered. | Rajasthan |
category | string | Shop category (only for Maharashtra). | COMMERCIAL II |
Result Object:
Key | Type | Description | Example Value |
---|---|---|---|
name | string | Name of the shop establishment. | MAHAWAR CABLE TV NETWORK |
registrationNumber | string | Shop registration number. | SCA/2020/14/135624 |
dateOfCommencement | string | Date when the shop establishment commenced operations. | 28/07/2020 |
status | string | Status of the shop establishment (e.g., VALID , EXPIRED ). | VALID |
summary | object | Summary details of the shop establishment. | (See below for detailed structure) |
Summary Object:
Key | Type | Description | Example Value |
---|---|---|---|
registrationNumber | string | Shop establishment registration number. | SCA/2020/14/135624 |
name | string | Name of the shop establishment. | MAHAWAR CABLE TV NETWORK |
status | string | Status of the shop establishment. | VALID |
dateOfCommencement | string | Date when the shop establishment commenced operations. | 28/07/2020 |
address | string | Address of the shop establishment (if available). | |
splitAddress | object | Split address details (district, city, state, etc.). | (See below for structure) |
SplitAddress Object:
Key | Type | Description |
---|---|---|
district | array | District(s) where the shop is located. |
state | array | State(s) where the shop is located. |
city | array | City where the shop is located. |
pincode | string | Pincode of the shop location. |
country | array | Country where the shop is located. |
addressLine | string | Complete address line (if available). |
Error Handling
If state_code
is MH
and the category
is missing:
Error Response for Missing Category:
{
"responseKey": "error_empty_category",
"message": "The state_code value of MH requires a mandatory category key as well, which can take one of the following values: [ Shop, Commercial, Restaurant and Eating House, Residential Hotel & Theatre and Public Amusement]"
}
Updated 14 days ago