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": "XXXXXXXXXXXXXXX",
    "legalName": "XXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "stateJurisdiction": "LGSTO 140 - Bengaluru",
    "stateJurisdictionCode": "KA030",
    "centralJurisdiction": "RANGE-DSD4",
    "centralJurisdictionCode": "YV0404",
    "rgdt": "01/07/2017",
    "constitutionOfBusiness": "Private Limited Company",
    "taxpayerType": "Regular",
    "gstnStatus": "Active",
    "lastUpdatedDate": "19/01/2022",
    "tradeName": "XXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "adadr": [
      {
        "addr": {
          "bnm": "SJR Cyber",
          "st": "22, Laskar Hosur Road, Adugodi",
          "loc": "Bangalore",
          "bno": "3rd and 4th Floor, SJR Cyber",
          "stcd": "Karnataka",
          "dst": "Bengaluru Urban",
          "flno": "3rd and 4th Floor",
          "pncd": "560030"
        },
        "ntr": "Recipient of Goods or Services, Import, Supplier of Services, Service Provision"
      },
      {
        "addr": {
          "bnm": "SJR Cyber",
          "st": "22, Laskar Hosur Road, Adugodi",
          "loc": "Bangalore",
          "bno": "6th Floor, SJR Cyber",
          "stcd": "Karnataka",
          "dst": "Bengaluru Urban",
          "flno": "6th Floor",
          "pncd": "560030"
        },
        "ntr": "Service Provision, Supplier of Services, Import, Recipient of Goods or Services"
      },
      {
        "addr": {
          "bnm": "SJR Cyber",
          "st": "22, Laskar Hosur Road, Adugodi",
          "loc": "Bangalore",
          "bno": "7th Floor, SJR Cyber",
          "stcd": "Karnataka",
          "dst": "Bengaluru Urban",
          "pncd": "560030"
        },
        "ntr": "Recipient of Goods or Services, Import, Service Provision, Supplier of Services"
      },
      {
        "addr": {
          "bnm": "SJR Cyber",
          "st": "22, Laskar Hosur Road, Adugodi",
          "loc": "Bangalore",
          "bno": "Ground Floor and Terrace Floor, SJR Cyber",
          "stcd": "Karnataka",
          "dst": "Bengaluru Urban",
          "pncd": "560030"
        },
        "ntr": "Service Provision, Supplier of Services, Import, Recipient of Goods or Services"
      },
      {
        "addr": {
          "bnm": "Salarpuria Arena",
          "st": "Laskar Hosur Road",
          "loc": "Adugodi",
          "bno": "No. 24, 3rd Floor",
          "stcd": "Karnataka",
          "dst": "Bengaluru Urban",
          "flno": "3rd Floor",
          "pncd": "560029"
        },
        "ntr": "Import, Supplier of Services, Recipient of Goods or Services"
      },
      {
        "addr": {
          "bnm": "Salarpuria Arena",
          "st": "Laskar Hosur Road",
          "loc": "Adugodi",
          "bno": "No. 24, 4th Floor",
          "stcd": "Karnataka",
          "dst": "Bengaluru Urban",
          "flno": "4th Floor",
          "pncd": "560029"
        },
        "ntr": "Import, Supplier of Services, Recipient of Goods or Services"
      }
    ],
    "primaryBusinessContact": {
      "address": {
        "buildingName": "SJR Cyber",
        "streetName": "22, laskar hosur road",
        "location": "Adugodi, Banglore",
        "buildingNumber": "First Floor",
        "stateName": "Karnataka",
        "district": "Bengaluru Urban",
        "floorNumber": "First Floor",
        "pincode": "560030"
      },
      "natureOfBusinessAtAddress": "Supplier of Services"
    },
    "pan": "AAGCR4375J"
  },
  "responseKey": "success_gstin",
  "responseCode": "S00000",
  "requestTimestamp": "2022-05-13 20:52:58.159147 IST (GMT +0530)",
  "responseTimestamp": "2022-05-13 20:52:58.410666 IST (GMT +0530)",
  "decentroTxnId": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}

πŸ˜ƒ

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"
}
{
  "apiStatus": "SUCCESS",
  "status": "SUCCESS",
  "message": "Advanced KYC Details for GSTIN retrieved successfully.",
  "kycResult": {
    "primaryBusinessContact": {
      "address": "First Floor, First Floor, SJR Cyber, 22, laskar hosur road, Adugodi, Banglore, Bengaluru Urban, Karnataka, 560030",
      "additionalAddress": "NA",
      "natureOfBusinessAtAddress": "Supplier of Services",
      "lastUpdatedDate": "NA"
    },
    "stateJurisdiction": "State - Karnataka,Division - DGSTO-2, Bengaluru, LOCAL GST Office - LGSTO 140 - Bengaluru",
    "taxpayerType": "Regular",
    "registrationDate": "01/07/2017",
    "constitutionOfBusiness": "Private Limited Company",
    "currentStatusOfRegistration": "Active",
    "tradeName": "XXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "gstin": "XXXXXXXXXXXXXXX",
    "directors": [
      "HARSHIL  MATHUR ",
      "Shashank kumar "
    ],
    "additionalPlacesOfBusinessInState": [
      {
        "email": "[email protected]",
        "address": "3rd and 4th Floor, SJR Cyber, 3rd and 4th Floor, SJR Cyber, 22, Laskar Hosur Road, Adugodi, Bangalore, Bengaluru Urban, Karnataka, 560030",
        "additionalAddress": "NA",
        "mobileNumber": 9999999999,
        "natureOfBusinessAtAddress": "Recipient of Goods or Services, Import, Supplier of Services, Service Provision",
        "lastUpdatedDate": "NA"
      },
      {
        "email": "[email protected]",
        "address": "6th Floor, SJR Cyber, 6th Floor, SJR Cyber, 22, Laskar Hosur Road, Adugodi, Bangalore, Bengaluru Urban, Karnataka, 560030",
        "additionalAddress": "NA",
        "mobileNumber": 9999999999,
        "natureOfBusinessAtAddress": "Service Provision, Supplier of Services, Import, Recipient of Goods or Services",
        "lastUpdatedDate": "NA"
      },
      {
        "email": "[email protected]",
        "address": "7th Floor, SJR Cyber, SJR Cyber, 22, Laskar Hosur Road, Adugodi, Bangalore, Bengaluru Urban, Karnataka, 560030",
        "additionalAddress": "NA",
        "mobileNumber": 9999999999,
        "natureOfBusinessAtAddress": "Recipient of Goods or Services, Import, Service Provision, Supplier of Services",
        "lastUpdatedDate": "NA"
      },
      {
        "email": "[email protected]",
        "address": "Ground Floor and Terrace Floor, SJR Cyber, SJR Cyber, 22, Laskar Hosur Road, Adugodi, Bangalore, Bengaluru Urban, Karnataka, 560030",
        "additionalAddress": "NA",
        "mobileNumber": 9999999999,
        "natureOfBusinessAtAddress": "Service Provision, Supplier of Services, Import, Recipient of Goods or Services",
        "lastUpdatedDate": "NA"
      },
      {
        "email": "[email protected]",
        "address": "No. 24, 3rd Floor, 3rd Floor, Salarpuria Arena, Laskar Hosur Road, Adugodi, Bengaluru Urban, Karnataka, 560029",
        "additionalAddress": "NA",
        "mobileNumber": 9999999999,
        "natureOfBusinessAtAddress": "Import, Supplier of Services, Recipient of Goods or Services",
        "lastUpdatedDate": "NA"
      },
      {
        "email": "[email protected]",
        "address": "No. 24, 4th Floor, 4th Floor, Salarpuria Arena, Laskar Hosur Road, Adugodi, Bengaluru Urban, Karnataka, 560029",
        "additionalAddress": "NA",
        "mobileNumber": 9999999999,
        "natureOfBusinessAtAddress": "Import, Supplier of Services, Recipient of Goods or Services",
        "lastUpdatedDate": "NA"
      }
    ],
    "businessDetails": [
      {
        "hsn": "997119",
        "serviceDetail": "Other financial services (except investment banking, insurance services and pension services)"
      },
      {
        "hsn": "997158",
        "serviceDetail": "Financial transactions processing and clearing house services"
      },
      {
        "hsn": "00440225",
        "serviceDetail": "BUSINESS AUXILIARY SERVICES"
      },
      {
        "hsn": "00440452",
        "serviceDetail": "INFORMATION TECHNOLOGY SOFTWARE SERVICE"
      }
    ],
    "legalName": "XXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "natureOfBusiness": [
      "Supplier of Services",
      "Recipient of Goods or Services",
      "Import",
      "Service Provision"
    ],
    "centralJurisdiction": "Commissionerate - BENGALURU-SOUTH,Division - SOUTH DIVISION-4,Range - RANGE-DSD4 (Jurisdictional Office)",
    "cxdt": "NA",
    "annualAggregateTurnover": "Slab: Rs. 500 Cr. and above",
    "mandatoryEInvoicing": "Yes",
    "grossTotalIncome": "Not Available",
    "grossTotalIncomeFinancialYear": "2019-2020",
    "isFieldVisitConducted": "No",
    "pan": "AAGCR4375J",
    "filingStatus": [
      {
        "filingYear": "2022-2023",
        "filingForMonth": "April",
        "filingMethod": "ONLINE",
        "filingDate": "11/05/2022",
        "filingGstType": "GSTR1",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2021-2022",
        "filingForMonth": "March",
        "filingMethod": "ONLINE",
        "filingDate": "11/04/2022",
        "filingGstType": "GSTR1",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2021-2022",
        "filingForMonth": "February",
        "filingMethod": "ONLINE",
        "filingDate": "11/03/2022",
        "filingGstType": "GSTR1",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2021-2022",
        "filingForMonth": "January",
        "filingMethod": "ONLINE",
        "filingDate": "11/02/2022",
        "filingGstType": "GSTR1",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2021-2022",
        "filingForMonth": "December",
        "filingMethod": "ONLINE",
        "filingDate": "11/01/2022",
        "filingGstType": "GSTR1",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2021-2022",
        "filingForMonth": "November",
        "filingMethod": "ONLINE",
        "filingDate": "11/12/2021",
        "filingGstType": "GSTR1",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2021-2022",
        "filingForMonth": "October",
        "filingMethod": "ONLINE",
        "filingDate": "11/11/2021",
        "filingGstType": "GSTR1",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2021-2022",
        "filingForMonth": "September",
        "filingMethod": "ONLINE",
        "filingDate": "11/10/2021",
        "filingGstType": "GSTR1",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2021-2022",
        "filingForMonth": "August",
        "filingMethod": "ONLINE",
        "filingDate": "11/09/2021",
        "filingGstType": "GSTR1",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2021-2022",
        "filingForMonth": "July",
        "filingMethod": "ONLINE",
        "filingDate": "11/08/2021",
        "filingGstType": "GSTR1",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2021-2022",
        "filingForMonth": "March",
        "filingMethod": "ONLINE",
        "filingDate": "20/04/2022",
        "filingGstType": "GSTR3B",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2021-2022",
        "filingForMonth": "February",
        "filingMethod": "ONLINE",
        "filingDate": "19/03/2022",
        "filingGstType": "GSTR3B",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2021-2022",
        "filingForMonth": "January",
        "filingMethod": "ONLINE",
        "filingDate": "20/02/2022",
        "filingGstType": "GSTR3B",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2021-2022",
        "filingForMonth": "December",
        "filingMethod": "ONLINE",
        "filingDate": "20/01/2022",
        "filingGstType": "GSTR3B",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2021-2022",
        "filingForMonth": "November",
        "filingMethod": "ONLINE",
        "filingDate": "20/12/2021",
        "filingGstType": "GSTR3B",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2021-2022",
        "filingForMonth": "October",
        "filingMethod": "ONLINE",
        "filingDate": "19/11/2021",
        "filingGstType": "GSTR3B",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2021-2022",
        "filingForMonth": "September",
        "filingMethod": "ONLINE",
        "filingDate": "20/10/2021",
        "filingGstType": "GSTR3B",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2021-2022",
        "filingForMonth": "August",
        "filingMethod": "ONLINE",
        "filingDate": "20/09/2021",
        "filingGstType": "GSTR3B",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2021-2022",
        "filingForMonth": "July",
        "filingMethod": "ONLINE",
        "filingDate": "20/08/2021",
        "filingGstType": "GSTR3B",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2021-2022",
        "filingForMonth": "June",
        "filingMethod": "ONLINE",
        "filingDate": "20/07/2021",
        "filingGstType": "GSTR3B",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2020-2021",
        "filingForMonth": "Annual",
        "filingMethod": "ONLINE",
        "filingDate": "28/02/2022",
        "filingGstType": "GSTR9",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2019-2020",
        "filingForMonth": "Annual",
        "filingMethod": "ONLINE",
        "filingDate": "12/01/2021",
        "filingGstType": "GSTR9",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2018-2019",
        "filingForMonth": "Annual",
        "filingMethod": "ONLINE",
        "filingDate": "22/09/2020",
        "filingGstType": "GSTR9",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2017-2018",
        "filingForMonth": "Annual",
        "filingMethod": "ONLINE",
        "filingDate": "25/01/2020",
        "filingGstType": "GSTR9",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2020-2021",
        "filingForMonth": "Annual",
        "filingMethod": "ONLINE",
        "filingDate": "28/02/2022",
        "filingGstType": "GSTR9C",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2019-2020",
        "filingForMonth": "Annual",
        "filingMethod": "ONLINE",
        "filingDate": "13/01/2021",
        "filingGstType": "GSTR9C",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2018-2019",
        "filingForMonth": "Annual",
        "filingMethod": "ONLINE",
        "filingDate": "23/09/2020",
        "filingGstType": "GSTR9C",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      },
      {
        "filingYear": "2017-2018",
        "filingForMonth": "Annual",
        "filingMethod": "ONLINE",
        "filingDate": "27/01/2020",
        "filingGstType": "GSTR9C",
        "filingAnnualReturn": "NA",
        "filingStatus": "Filed"
      }
    ]
  },
  "responseKey": "success_gstin",
  "responseCode": "S00000",
  "requestTimestamp": "2022-05-13 20:55:21.280899 IST (GMT +0530)",
  "responseTimestamp": "2022-05-13 20:55:22.472006 IST (GMT +0530)",
  "decentroTxnId": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}

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": "SUCCESS",
  "kycStatus": "SUCCESS",
  "message": "KYC Details for CIN retrieved successfully.",
  "kycResult": {
    "companyMasterData": {
      "companyCategory": "Company limited by Shares",
      "emailId": "[email protected]",
      "classOfCompany": "Private",
      "numberOfMembersApplicableInCaseOfCompanyWithoutShareCapital": "0",
      "addressOtherThanRegisteredOfficeWhereAllOrAnyBooksOfAccountAndPapersAreMaintained": "NA",
      "dateOfLastAgm": "DD/MM/YYYY",
      "registeredAddress": "xxxxxxxxxxxxxxxx",
      "activeCompliance": "ACTIVE compliant",
      "registrationNumber": "xxxxxx",
      "paidUpCapitalInInr": "100000",
      "whetherListedOrNot": "Unlisted",
      "suspendedAtStockExchange": "NA",
      "companySubcategory": "Non-govt company",
      "authorisedCapitalInInr": "100000",
      "companyStatusForEFiling": "Active",
      "rocCode": "RoC-Chennai",
      "dateOfBalanceSheet": "DD/MM/YYYY",
      "dateOfIncorporation": "DD/MM/YYYY",
      "cinΒ ": "xxxxxxxxxxxxxxxxxxxx",
      "companyName": "xxxxxxxxxxxxxxxxxxxxxx"
    },
    "charges": [],
    "directors": [
      {
        "endDate": "NA",
        "surrenderedDin": "NA",
        "dinOrPan": "xxxxxxxx",
        "beginDate": "DD/MM/YYYY",
        "name": "xxxxxx xxxxxxx"
      },
      {
        "endDate": "NA",
        "surrenderedDin": "NA",
        "dinOrPan": "xxxxxxxx",
        "beginDate": "DD/MM/YYYY",
        "name": "xxxxxx xxxxxx xxxxxx"
      }
    ]
  },
  "responseKey": "success_cin",
  "responseCode": "S00000",
  "requestTimestamp": "2023-05-18 13:21:48.887661 IST (GMT +0530)",
  "responseTimestamp": "2023-05-18 13:21:49.806250 IST (GMT +0530)",
  "decentroTxnId": "DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}

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

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"
}
{
  "kycStatus": "SUCCESS",
  "kycResult": {
    "uamNumber": "AA00A0000000",
    "enterpriseName": "Enterprise Name",
    "majorActivity": "SERVICES",
    "socialCategory": "XXX",
    "enterpriseType": "XXXXX",
    "dateOfCommencement": "22/10/2018",
    "district": "XXXXXXXXX",
    "state": "MADHYA PRADESH",
    "appliedDate": "DD/MM/YYYY",
    "modifiedDate": "N/A",
    "expiryDate": "DD/MM/YYYY",
    "nic_2Digit": "XX-INFORMATION SERVICE ACTIVITIES",
    "nic_4Digit": "XXXX-WEB PORTALS",
    "nic_5Digit": "XXXXX-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",
    "status": "ACTIVE"
  },
  "responseKey": "success_udyog_aadhaar",
  "responseCode": "S00000",
  "requestTimestamp": "2023-01-13 14:47:23.181764 IST (GMT +0530)",
  "responseTimestamp": "2023-01-13 14:47:25.248805 IST (GMT +0530)",
  "decentroTxnId": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}

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

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": "SUCCESS",
    "kycStatus": "SUCCESS",
    "message": "KYC Details for DIN retrieved successfully.",
    "kycResult": {
        "llpData": [],
        "companyData": [
            {
                "endDate": "NA",
                "activeCompliance": "ACTIVE Non-Compliant",
                "companyName": "XXXXXXXXXXXXXXXXX",
                "beginDate": "02/03/2017",
                "cinOrFcrn": "XXXXXXXXXXXXXXXXX"
            }
        ],
        "directorData": {
            "din": "XXXXXXXX",
            "name": "XXXXXXXXXXXXXXXXX"
        }
    },
    "responseKey": "success_din",
    "responseCode": "S00000",
    "requestTimestamp": "2023-08-30 18:14:42.317284 IST (GMT +0530)",
    "responseTimestamp": "2023-08-30 18:14:43.976432 IST (GMT +0530)",
    "decentroTxnId": "DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}

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