Business Verification

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 DocumentsDescription
PANA 10-character alphanumeric PAN number
GSTINA 15-character GSTIN number
CINCorporate Identification Number provided by MCA
DINDirector Identification Number (DIN)
UdyamAnother unique registration number for Micro, Small, and Medium Enterprises (MSMEs) is provided by the Indian Ministry of MSMEs
Udyog Aadhaar12-digit unique identification number provided by the Indian Ministry of MSMEs
FLLPINForeign Limited Liability Partnership Identification Number issued to any foreign organisation incorporated as an LLP in India
LLPINLimited Liability Partnership Identification number issued to any organization incorporated an LLP in India
FCRN6-character Foreign Company Registration Number
FSSAIThe 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 PANBusiness PAN
A ten-digit alphanumeric ID numberA ten-digit alphanumeric ID number
It belongs to a personIt 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

{
  "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": "Y"
  },
  "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 NameDescription
apiStatusIndicates the status of the API request.
statusIndicates the overall status of the operation.
messageA descriptive message accompanying the response, providing information about the outcome.
kycResultA JSON object containing advanced KYC details retrieved for the GSTIN.
- primaryBusinessContactDetails about the primary business contact, including address, nature of business, etc.
- addressAddress of the primary business contact.
- additionalAddressAdditional address details of the primary business contact.
- natureOfBusinessAtAddressNature of business at the primary business contact's address.
- lastUpdatedDateDate when the information was last updated.
- stateJurisdictionState jurisdiction details for the GSTIN.
- taxpayerTypeType of taxpayer (e.g., Regular, Composition).
- registrationDateDate of registration for the GSTIN.
- constitutionOfBusinessConstitution of the business (e.g., Private Limited Company, Partnership, etc.).
- currentStatusOfRegistrationCurrent status of the GST registration (e.g., Active, Inactive).
- tradeNameTrade name associated with the GSTIN.
- gstinGoods and Services Taxpayer Identification Number (GSTIN).
- directorsList of directors associated with the business.
- additionalPlacesOfBusinessInStateAdditional places of business within the state, including address, nature of business, etc.
- businessDetailsDetails about the business, including HSN code and service details.
- legalNameLegal name of the business.
- natureOfBusinessNature of business activities associated with the business.
- centralJurisdictionCentral jurisdiction details for the GSTIN.
- cxdtCentral excise registration details.
- annualAggregateTurnoverAnnual aggregate turnover for the GSTIN.
- mandatoryEInvoicingIndicates whether e-invoicing is mandatory for the GSTIN.
- grossTotalIncomeGross total income of the business.
- grossTotalIncomeFinancialYearThe financial year for the gross total income.
- isFieldVisitConductedIndicates whether a field visit was conducted.
- panPermanent Account Number (PAN) associated with the business.
- filingStatusDetails about filing status, including year, month, method, date, GST type, annual return, and status.
- filingYearYear of filing.
- filingForMonthMonth for which filing was done.
- filingMethodMethod of filing (e.g., ONLINE, OFFLINE).
- filingDateDate of filing.
- filingGstTypeType of GST filing (e.g., GSTR1, GSTR3B).
- filingAnnualReturnAnnual return filing status.
- filingStatusStatus of filing (e.g., Filed, Pending).
responseKeyA key indicating the success of the GSTIN retrieval request.
responseCodeA code indicating the outcome of the request.
requestTimestampTimestamp when the request was made.
responseTimestampTimestamp when the response was received.
decentroTxnIdThe 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/<YOUR DECENTRO TRANSACTION ID>.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.

{
  "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 NameDescription
kycStatusIndicates the status of the Know Your Customer (KYC) process.
kycResultA JSON object containing detailed KYC information.
- idNumberIdentification number associated with the entity.
- licenseTypeType of license (e.g., REGISTRATION).
- entityNameName of the entity.
- statusStatus of the entity (e.g., ACTIVE).
- premissesAddressAddress details of the premises, including district, address, state, and pincode.
- districtDistrict of the premises address.
- addressAddress line of the premises.
- stateState of the premises address.
- pincodePincode of the premises address.
- productsList of products associated with the entity, including serial number and food product category.
- slNoSerial number of the product.
- foodProductCategoryCategory of the food product.
- addressAddress details of the entity, including district, state, city, pincode, country, and address line.
- districtDistrict of the entity's address.
- stateState of the entity's address.
- cityCity of the entity's address.
- pincodePincode of the entity's address.
- countryCountry code of the entity's address.
- addressLineAddress line of the entity.
responseKeyA key indicating the success of the FSSAI (Food Safety and Standards Authority of India) retrieval request.
responseCodeA code indicating the outcome of the request.
requestTimestampTimestamp when the request was made.
responseTimestampTimestamp when the response was received.
decentroTxnIdThe 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 NameDescription
kycStatusIndicates the status of the Know Your Customer (KYC) process.
kycResultA JSON object containing detailed KYC information.
- uamNumberUdyog Aadhaar Memorandum (UAM) number associated with the enterprise.
- enterpriseNameName of the enterprise.
- majorActivityThe primary activity of the enterprise.
- socialCategorySocial category of the enterprise.
- enterpriseTypeType of enterprise.
- dateOfCommencementDate of commencement of business operations.
- districtDistrict where the enterprise is located.
- stateState where the enterprise is located.
- appliedDateDate when the KYC information was applied.
- modifiedDateDate when the KYC information was last modified.
- expiryDateExpiry date of the KYC information.
- nic_2Digit2-digit National Industrial Classification (NIC) code representing the enterprise's activity.
- nic_4Digit4-digit NIC code representing the enterprise's activity.
- nic_5Digit5-digit NIC code representing the enterprise's activity.
- statusStatus of the enterprise (e.g., ACTIVE).
responseKeyA key indicating the success of the Udyog Aadhaar retrieval request.
responseCodeA code indicating the outcome of the request.
requestTimestampTimestamp when the request was made.
responseTimestampTimestamp when the response was received.
decentroTxnIdThe transaction ID is generated by Decentro for tracking purposes.

6. Udyam Registration

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 key

Now, you can download the Udyam Certificate for valid Udyam numbers by passing the optional generate_pdf key as true.

The following is a table defining each parameter in the given response body:

Parameter NameDescription
decentroTxnIdThe transaction ID generated by Decentro for tracking purposes.
statusIndicates the status of the request, whether it was successful or not.
responseCodeA code indicating the outcome of the request.
messageA descriptive message accompanying the response, providing information about the outcome.
dataA JSON object containing detailed information about the enterprise and its registration details.
- udyamNumberThe unique Udyam registration number is assigned to the enterprise.
- enterpriseNameThe name of the enterprise.
- organisationTypeThe type of organization, such as Private Limited Company, Sole Proprietorship, etc.
- majorActivityThe primary activity of the enterprise.
- genderGender of the enterprise owner or representative.
- socialCategorySocial category of the enterprise owner or representative.
- incorporationDateDate of incorporation of the enterprise.
- commencementDateDate of commencement of business operations.
- enterpriseOfficialAddressOfficial address details of the enterprise, including flat, building, village, city, etc.
- dicDistrict Industrial Center where the enterprise is registered.
- msmeDfoMSME Development Forum associated with the enterprise.
- udyamRegistrationDateDate of Udyam registration.
- enterpriseTypeDetails about the enterprise type, including classification and registration dates.
- serialNumberSerial number assigned to the enterprise type.
- dataYearYear of data for the enterprise type classification.
- classificationYearYear of classification of the enterprise type.
- enterpriseTypeType of enterprise (e.g., Micro, Small, Medium).
- classificationDateDate of classification of the enterprise type.
- unitLocationDetailsDetails about the location of the enterprise unit.
- serialNumberSerial number assigned to the unit location details.
- unitNameName of the enterprise unit.
- flatFlat number of the unit.
- buildingBuilding name of the unit.
- villageVillage where the unit is located.
- blockBlock where the unit is located.
- roadRoad where the unit is located.
- cityCity where the unit is located.
- pinPIN code of the unit location.
- stateState where the unit is located.
- districtDistrict where the unit is located.
- nationalIndustryClassificationCodeDetails about the National Industry Classification (NIC) code of the enterprise's activity.
- serialNumberSerial number assigned to the NIC code details.
- nic2Digit2-digit NIC code representing the industry classification.
- nic4Digit4-digit NIC code representing the industry classification.
- nic5Digit5-digit NIC code representing the industry classification.
- activityActivity associated with the NIC code.
- dateDate of NIC code assignment.
responseKeyA 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"
}

Udyam Verification

βœ…

Recommended - Simple Udyam Verification Flow

We have one step process to Verify Udyam Aadhaar Number in Validate API. Refer here for the product guide

Decentro brings Udyam Verification API which the customer can use to validate and fetch information related to a valid Udyam Number. Udyam is also known as MSME (Ministry of Micro, Small & Medium Enterprises).

  • Companies can get their Udyam Certificate to certify that they are small or medium businesses or enterprises.

Product Flow

There are two APIs in the flow to validate Udyam. Below are APIs to use in the sequence -

  • Initiate Session - This API initiates a session that gives a captcha in Base64 format.
  • Validate Udyam - This API requires two pieces of information from the Initiate Session API along with udyam_number -
    a) Initiation Decentro Transaction ID - This comes in the response of the Initiate Session API.
    b) Captcha - A valid captcha to pass in the request body parameter of Validate Udyam

Initiate Session

This API initiates a valid session with Udyam. It gives the following that has to be passed mandatorily in the Validate Udyam API -

  • Captcha
  • Decentro Transaction ID
{
    "reference_id": "3a79105d-bb14-4f7c-be3f-02c89ff9ccea",
    "consent": true,
    "purpose": "For Udyam Verification"
}
{
  "decentroTxnId": "DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "status": "SUCCESS",
  "responseCode": "S00000",
  "message": "Session created successfully.",
  "data": {
    "captchaBase64": "Base64 of Captcha"
  },
  "responseKey": "success_session_created"
}

Validate Udyam

This API validates the Udyam. Udyam Number has to be passed in the request body for this API along with a captcha and initiation_transaction_id.

{
    "reference_id": "d027b856-1ac9-4e80-9324-1f5f161aaa24",
    "initiation_transaction_id": "DXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "udyam_number": "UDYAM-AA-00-0000000",
    "captcha": "Q5R5PC",
    "consent": true,
    "purpose": "For Udyam Verification"
}
{
  "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_verification"
}