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 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 organisation incorporated as an LLP in India
LLPIN	Limited Liability Partnership Identification number issued to any organization incorporated 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 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.

{
  "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 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 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 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 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"
}

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"
}

Business Verification

😁
Regex Builder

Supported Documents

📘
Document Type Enumeration Standardized

1. PAN

😃
PAN Detailed - Individual and Business PAN

👍
Additional Configurations in the `PAN_DETAILED` Document Type

2. GSTIN

😃
GSTIN Detailed

👍
Downloadable PDF Reports

3. CIN

4. FSSAI Card

5. Udyog Aadhaar

6. Udyam Registration

👍
Optional `generate_pdf` key

7. FLLPIN

8. DIN

9. LLPIN

10. FCRN

Udyam Verification

✅
Recommended - Simple Udyam Verification Flow

Product Flow

Initiate Session

Validate Udyam

😁Regex Builder

Supported Documents

📘Document Type Enumeration Standardized

1. PAN

😃PAN Detailed - Individual and Business PAN

👍Additional Configurations in the PAN_DETAILED Document Type

2. GSTIN

😃GSTIN Detailed

👍Downloadable PDF Reports

3. CIN

4. FSSAI Card

5. Udyog Aadhaar

6. Udyam Registration

👍Optional generate_pdf key

7. FLLPIN

8. DIN

9. LLPIN

10. FCRN

Udyam Verification

✅Recommended - Simple Udyam Verification Flow

Product Flow

Initiate Session

Validate Udyam

😁
Regex Builder

📘
Document Type Enumeration Standardized

😃
PAN Detailed - Individual and Business PAN

👍
Additional Configurations in the `PAN_DETAILED` Document Type

😃
GSTIN Detailed

👍
Downloadable PDF Reports

👍
Optional `generate_pdf` key

✅
Recommended - Simple Udyam Verification Flow