--- agentTools: projectIndex: https://docs.decentro.tech/llms.txt --- # Business Verification Validate API > 🙌 Important Note > > Please use only **Staging Credentials** on each API Reference page to test the APIs directly from our Documentation. ### API Endpoints | Environment | Endpoint | | :---------------- | :-------------------------------------------------------------- | | Staging / Sandbox | | | Production | | Our Validate API supports multiple documents. You can use any document mentioned in the below list - * PAN, GSTIN, FSSAI, UDYOG\_AADHAAR, CIN, DIN, LLPIN, FLLPIN, FCRN, Udyam Number You can also use **PAN\_DETAILED** to get detailed information ## Input Validations for `GSTIN_DETAILED` Document Type | Field | Requirement | | ----------------- | ------------------------------------------------------------ | | `reference_id` | Required (String, Not Blank) | | `document_type` | Required (String, Not Blank) (`"GSTIN_DETAILED"`) | | `id_number` | Required (String, Not Blank) | | `consent` | Required (String, Not Blank) (`'Y', 'N'`) → Required (`'Y'`) | | `consent_purpose` | Required (String, Not Blank) (SIZE > 20) | | `generate_pdf` | Not Required (Boolean) Default (`False`) |
> 👍 Download GSTIN Certificate > > You can now set the `generate_pdf` key to true and get a PDF download link available in the response under the key - `pdf`. > > Albeit the link is sent to you, you can also generate the link on the fly if needed. You can download the file using the endpoint `https://in.decentro.tech/v2/common/download/.pdf`. > > Please note, in order for the download to work, `client_id` and `client_secret` must be present in the headers. You can refer the [Download PDF File](https://docs.decentro.tech/reference/kyc-and-onboarding-api-reference-utilities-download-pdf-files) Utility API Reference to learn more. > 📘 Validate API Response Keys > > Here are the Response Keys and the scenarios under which Decentro will propagate the same to the platform - [Response Keys](https://docs.decentro.tech/docs/response-keys-kyc#validate) # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "Decentro Staging", "version": "1.0" }, "servers": [ { "url": "https://in.staging.decentro.tech" } ], "security": [ {} ], "paths": { "/kyc/public_registry/validate#business-verification": { "post": { "summary": "Business Verification Validate API", "description": "", "operationId": "kyc-and-onboarding-api-reference-identities-verification-services-business-verification-validate-api", "parameters": [ { "name": "client_id", "in": "header", "description": "ID/identifier that is provided by Decentro to a specific client and environment. Please note, this may change based on the environment you are on.", "required": true, "schema": { "type": "string" } }, { "name": "client_secret", "in": "header", "description": "The confidential credential provided by Decentro that is associated with the client_id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "reference_id", "document_type", "id_number", "consent", "consent_purpose" ], "properties": { "reference_id": { "type": "string", "description": "Any unique ID assigned by you for this request" }, "document_type": { "type": "string", "description": "The type of ID that you want to validate. Only special character allowed is underscore." }, "id_number": { "type": "string", "description": "The national ID number that is present on the above document" }, "consent": { "type": "string", "description": "Y/N based on the consent given by the customer. Mandatory as per regulation." }, "consent_purpose": { "type": "string", "description": "The purpose of taking this consent from your customer. Mandatory as per regulation. (>20 characters)" } } }, "examples": { "Success: Business PAN": { "value": { "reference_id": "Business PAN", "document_type": "PAN", "id_number": "XXXXXXXXXX", "consent": "Y", "consent_purpose": "Checking Business PAN details" } }, "Success: No records found": { "value": { "reference_id": "0000-0000-0000-2005", "document_type": "PAN", "id_number": "XXXXXXXXXX", "consent": "Y", "consent_purpose": "For bank account purpose only" } }, "Failure: Invalid Document": { "value": { "reference_id": "0000-0000-0000-2005", "document_type": "PAN", "id_number": "XXXXX", "consent": "Y", "consent_purpose": "For bank account purpose only" } }, "Success: GSTIN": { "value": { "reference_id": "GSTIN Document Verification", "document_type": "GSTIN", "id_number": "XXXXXXXXXXX", "consent": "Y", "consent_purpose": "To verify GSTIN document" } }, "Success: GSTIN_DETAILED": { "value": { "reference_id": "GSTIN-Detailed Document Verification", "document_type": "GSTIN_DETAILED", "id_number": "XXXXXXXXXXX", "consent": "Y", "consent_purpose": "To verify GSTIN document" } }, "Success: CIN": { "value": { "reference_id": "CIN Document Verification", "document_type": "CIN", "id_number": "XXXXXXXXXXX", "consent": "Y", "consent_purpose": "To verify CIN document" } }, "Success: FSSAI": { "value": { "reference_id": "FSSAI Document Verification", "document_type": "FSSAI", "id_number": "XXXXXXXXXXX", "consent": "Y", "consent_purpose": "To verify FSSAI document" } }, "Failure: Empty Reference ID": { "value": { "reference_id": "", "initiation_transaction_id": "DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "udyam_number": "UDYAM-XX-00-0000000", "captcha": "Q5R5PC", "consent": true, "consent_purpose": "To verify the document" } }, "Failure: False Consent": { "value": { "reference_id": "ManishGupta", "document_type": "PAN", "id_number": "XXXXXXXXXX", "consent": "N", "consent_purpose": "To verify the document" } }, "Failure: Empty Purpose": { "value": { "reference_id": "ManishGupta", "document_type": "PAN", "id_number": "XXXXXXXXXX", "consent": "Y", "consent_purpose": "" } }, "Failure: Short Purpose Length": { "value": { "reference_id": "ManishGupta", "document_type": "PAN", "id_number": "XXXXXXXXXX", "consent": "Y", "consent_purpose": "Short Purpose" } }, "Success: UDYOG_AADHAAR": { "value": { "reference_id": "Udyog Aadhaar Document Verification", "document_type": "UDYOG_AADHAAR", "id_number": "XXXXXXXXXXX", "consent": "Y", "consent_purpose": "To verify Udyog Aadhaar document" } }, "Success: UDYAM": { "value": { "reference_id": "Udyam Document Verification", "document_type": "UDYAM", "id_number": "XXXXXXXXXXX", "consent": "Y", "consent_purpose": "To verify Udyam document" } }, "Success: FLLPIN": { "value": { "reference_id": "FLLPIN Document Verification", "document_type": "FLLPIN", "id_number": "XXXXXXXXXXX", "consent": "Y", "consent_purpose": "To verify FLLPIN document" } }, "Success: DIN": { "value": { "reference_id": "DIN Document Verification", "document_type": "DIN", "id_number": "XXXXXXXXXXX", "consent": "Y", "consent_purpose": "To verify DIN document" } }, "Success: LLPIN": { "value": { "reference_id": "LLPIN Document Verification", "document_type": "LLPIN", "id_number": "XXXXXXXXXXX", "consent": "Y", "consent_purpose": "To verify LLPIN document" } }, "Success: FCRN": { "value": { "reference_id": "FCRN Document Verification", "document_type": "FCRN", "id_number": "XXXXXXXXXXX", "consent": "Y", "consent_purpose": "To verify FCRN document" } } } } } }, "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Success: Business PAN": { "value": "{\n \"kycStatus\": \"SUCCESS\",\n \"status\": \"SUCCESS\",\n \"message\": \"KYC Details for PAN retrieved successfully\",\n \"kycResult\": {\n \"idNumber\": \"ABCDE12345\",\n \"idStatus\": \"VALID\",\n \"name\": \"AMAZON SELLER SERVICES PRIVATE LIMITED\"\n },\n \"responseKey\": \"success_pan\",\n \"responseCode\": \"S00000\",\n \"requestTimestamp\": \"2020-07-24 21:25:20.778016 IST (GMT +0530)\",\n \"responseTimestamp\": \"2020-07-24 21:25:21.991470 IST (GMT +0530)\",\n \"decentroTxnId\": \"DECXXXXXXXXXXXXXXXXXXXXXXXXXXX\"\n}" }, "Success: No records found": { "value": "{\n \"status\": \"SUCCESS\",\n \"kycStatus\": \"FAILURE\",\n \"error\": {\n \"message\": \"No records found for the given ID.\",\n \"responseCode\": \"E00021\"\n },\n \"responseKey\": \"error_invalid_pan\",\n \"requestTimestamp\": \"2023-03-20 15:03:40.178215 IST (GMT +0530)\",\n \"responseTimestamp\": \"2023-03-20 15:03:43.009710 IST (GMT +0530)\",\n \"decentroTxnId\": \"DECXXXXXXXXXXXXXXXXXXXXXXXXXXX\"\n}" }, "Success: GSTIN": { "value": "{\n \"kycStatus\": \"SUCCESS\",\n \"status\": \"SUCCESS\",\n \"message\": \"KYC Details for GSTIN retrived successfully.\",\n \"kycResult\": {\n \"gstin\": \"XXXXXXXXXXXXXX\",\n \"legalName\": \"XXXXXXXXXXXXXXXXXXXX\",\n \"stateJurisdiction\": \"LGSTO 045 - Bengaluru\",\n \"centralJurisdiction\": \"RANGE-AED2\",\n \"centralJurisdictionCode\": \"YT0201\",\n \"constitutionOfBusiness\": \"Private Limited Company\",\n \"taxpayerType\": \"Regular\",\n \"natureOfBusiness\": [\n \"Export\",\n \"Supplier of Services\",\n \"Import\"\n ],\n \"natureOfCoreBusinessActivity\": \"Service Provider and Others\",\n \"gstnStatus\": \"Active\",\n \"tradeName\": \"XXXXXXXXXXXXXXXXX\",\n \"registrationDate\": \"04/09/2020\",\n \"principalPlaceOfBusiness\": \"Indiranagar, Bengaluru, Bengaluru Urban, Karnataka, 560038\",\n \"pan\": \"XXXXXXXXXX\",\n \"registrationType\": \"NORMAL COMPOSITE CASUAL\"\n },\n \"responseKey\": \"success_gstin\",\n \"responseCode\": \"S00000\",\n \"requestTimestamp\": \"2024-06-09 17:42:21.078532 IST (GMT +0530)\",\n \"responseTimestamp\": \"2024-06-09 17:42:22.027391 IST (GMT +0530)\",\n \"decentroTxnId\": \"XXXXXXXXXX\"\n}" }, "Success: GSTIN_DETAILED": { "value": "{\n \"kycStatus\": \"******\",\n \"status\": \"******\",\n \"message\": \"***********************************************\",\n \"kycResult\": {\n \"gstin\": \"*******************\",\n \"legalName\": \"*******************************\",\n \"stateJurisdiction\": \"***********************\",\n \"centralJurisdiction\": \"************\",\n \"centralJurisdictionCode\": \"******\",\n \"constitutionOfBusiness\": \"***********************\",\n \"taxpayerType\": \"*******\",\n \"natureOfBusiness\": [\n \"******\",\n \"*******************\",\n \"******\"\n ],\n \"natureOfCoreBusinessActivity\": \"*****************************\",\n \"annualAggregateTurnover\": \"******\",\n \"gstnStatus\": \"******\",\n \"tradeName\": \"*******************************\",\n \"registrationDate\": \"**********\",\n \"principalPlaceOfBusiness\": \"********************************************\",\n \"pan\": \"***********\",\n \"registrationType\": \"****************************\",\n \"businessDetails\": [\n {\n \"hsn\": \"******\",\n \"type\": \"********\",\n \"description\": \"*******************************************************\"\n }\n ],\n \"filingStatus\": [\n {\n \"filingYear\": \"*********\",\n \"filingPeriod\": \"*****\",\n \"filingMethod\": \"******\",\n \"filingDate\": \"**********\",\n \"filingGstType\": \"******\",\n \"filingAnnualReturn\": \"**\",\n \"filingStatus\": \"*****\"\n }\n ],\n \"cinData\": {\n \"charges\": [],\n \"directors\": [\n {\n \"endDate\": \"**\",\n \"dinOrPan\": \"********\",\n \"beginDate\": \"**********\",\n \"name\": \"************\"\n },\n {\n \"endDate\": \"**\",\n \"dinOrPan\": \"********\",\n \"beginDate\": \"**********\",\n \"name\": \"*******************************\"\n }\n ],\n \"companyMasterData\": {\n \"companyCategory\": \"*******************************\",\n \"emailId\": \"*****************\",\n \"classOfCompany\": \"******\",\n \"numberOfMembersApplicableInCaseOfCompanyWithoutShareCapital\": \"**\",\n \"addressOtherThanRegisteredOfficeWhereAllOrAnyBooksOfAccountAndPapersAreMaintained\": \"**\",\n \"dateOfLastAgm\": \"**********\",\n \"registeredAddress\": \"****************************************************************\",\n \"registrationNumber\": \"*******\",\n \"paidUpCapitalInInr\": \"*******\",\n \"whetherListedOrNot\": \"********\",\n \"suspendedAtStockExchange\": \"**\",\n \"cin\": \"********************\",\n \"companySubcategory\": \"******************\",\n \"authorisedCapitalInInr\": \"********\",\n \"companyStatusForEFiling\": \"******\",\n \"rocCode\": \"*********\",\n \"dateOfBalanceSheet\": \"**********\",\n \"dateOfIncorporation\": \"**********\",\n \"companyName\": \"*******************************\",\n \"activeCompliance\": \"**\",\n \"mainDivisionOfBusinessActivityToBeCarriedOutInIndia\": \"**\",\n \"previousFircompanyDetailifApplicable\": \"**\",\n \"numberOfDesignatedPartners\": \"**\",\n \"totalObligationOfContribution\": \"*\",\n \"descriptionOfMainDivision\": \"*********************************************************\",\n \"numberOfPartners\": \"**\"\n }\n },\n \"pdf\": \"********************************************\"\n },\n \"responseKey\": \"*************\",\n \"responseCode\": \"******\",\n \"requestTimestamp\": \"*****************************************\",\n \"responseTimestamp\": \"*****************************************\",\n \"decentroTxnId\": \"*************************************\"\n}" }, "Success: CIN": { "value": "{\n \"status\": \"SUCCESS\",\n \"kycStatus\": \"SUCCESS\",\n \"message\": \"KYC Details for CIN retrieved successfully.\",\n \"kycResult\": {\n \"companyMasterData\": {\n \"companyCategory\": \"Company limited by Shares\",\n \"emailId\": \"xxxxxx@xxxxxxxxxxx.com\",\n \"classOfCompany\": \"Private\",\n \"numberOfMembersApplicableInCaseOfCompanyWithoutShareCapital\": \"0\",\n \"addressOtherThanRegisteredOfficeWhereAllOrAnyBooksOfAccountAndPapersAreMaintained\": \"NA\",\n \"dateOfLastAgm\": \"DD/MM/YYYY\",\n \"registeredAddress\": \"xxxxxxxxxxxxxxxx\",\n \"activeCompliance\": \"ACTIVE compliant\",\n \"registrationNumber\": \"xxxxxx\",\n \"paidUpCapitalInInr\": \"100000\",\n \"whetherListedOrNot\": \"Unlisted\",\n \"suspendedAtStockExchange\": \"NA\",\n \"companySubcategory\": \"Non-govt company\",\n \"authorisedCapitalInInr\": \"100000\",\n \"companyStatusForEFiling\": \"Active\",\n \"rocCode\": \"RoC-Chennai\",\n \"dateOfBalanceSheet\": \"DD/MM/YYYY\",\n \"dateOfIncorporation\": \"DD/MM/YYYY\",\n \"cin \": \"xxxxxxxxxxxxxxxxxxxx\",\n \"companyName\": \"xxxxxxxxxxxxxxxxxxxxxx\"\n },\n \"charges\": [],\n \"directors\": [\n {\n \"endDate\": \"NA\",\n \"surrenderedDin\": \"NA\",\n \"dinOrPan\": \"xxxxxxxx\",\n \"beginDate\": \"DD/MM/YYYY\",\n \"name\": \"xxxxxx xxxxxxx\"\n },\n {\n \"endDate\": \"NA\",\n \"surrenderedDin\": \"NA\",\n \"dinOrPan\": \"xxxxxxxx\",\n \"beginDate\": \"DD/MM/YYYY\",\n \"name\": \"xxxxxx xxxxxx xxxxxx\"\n }\n ]\n },\n \"responseKey\": \"success_cin\",\n \"responseCode\": \"S00000\",\n \"requestTimestamp\": \"2023-05-18 13:21:48.887661 IST (GMT +0530)\",\n \"responseTimestamp\": \"2023-05-18 13:21:49.806250 IST (GMT +0530)\",\n \"decentroTxnId\": \"DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\"\n}" }, "Success: FSSAI": { "value": "{\n \"kycStatus\": \"SUCCESS\",\n \"kycResult\": {\n \"idNumber\": \"11111111111111\",\n \"licenseType\": \"REGISTRATION\",\n \"entityName\": \"NAME\",\n \"status\": \"ACTIVE\",\n \"premissesAddress\": {\n \"district\": \"\",\n \"address\": \"Some Address Line\",\n \"state\": \"WEST BENGAL\",\n \"pincode\": \"XXXXXX\"\n },\n \"products\": [\n {\n \"slNo\": \"2\",\n \"foodProductCategory\": \"02 - Product Category Name\"\n },\n {\n \"slNo\": \"13\",\n \"foodProductCategory\": \"13 - Product Category Name\"\n }\n ],\n \"address\": {\n \"district\": [\n \"EAST MIDNAPORE\"\n ],\n \"state\": [\n [\n \"WEST BENGAL\",\n \"WB\"\n ]\n ],\n \"city\": [\n \"KHANJANCHAK\"\n ],\n \"pincode\": \"XXXXXX\",\n \"country\": [\n \"IN\",\n \"IND\",\n \"INDIA\"\n ],\n \"addressLine\": \"Some Address Line\"\n }\n },\n \"responseKey\": \"success_fssai\",\n \"responseCode\": \"S00000\",\n \"requestTimestamp\": \"2023-01-13 14:57:22.932451 IST (GMT +0530)\",\n \"responseTimestamp\": \"2023-01-13 14:57:23.866098 IST (GMT +0530)\",\n \"decentroTxnId\": \"DECXXXXXXXXXXXXXXXXXXXXXXXXXXX\"\n}" }, "Success: UDYOG_AADHAAR": { "value": "{\n \"status\": \"SUCCESS\",\n \"kycStatus\": \"SUCCESS\",\n \"message\": \"KYC Details for Udyog Aadhaar retrieved successfully.\",\n \"kycResult\": {\n \"uamNumber\": \"XXXXXXXXX\",\n \"enterpriseName\": \"ABC ONLINE AND PHOTOCOPY\",\n \"majorActivity\": \"SERVICES\",\n \"socialCategory\": \"OBC\",\n \"enterpriseType\": \"MICRO\",\n \"mobile\": \"89*****168\",\n \"email\": \"NE******14@GMAIL.COM\",\n \"dateOfCommencement\": \"22/10/2018\",\n \"dicName\": \"VIDISHA\",\n \"state\": \"MADHYA PRADESH\",\n \"appliedDate\": \"12/12/2018\",\n \"modifiedDate\": \"N/A\",\n \"address\": {\n \"serialNumber\": \"1\",\n \"flatDoorBlockNumber\": \"XXXXXXXXX\",\n \"nameOfPremisesBuildingVillage\": \"XXXXXXXXX\",\n \"roadStreetLane\": \"XXXXXXXXX\",\n \"areaLocality\": \"XXXXXXXXX\",\n \"city\": \"XXXXXXXXX\",\n \"pin\": \"XXXXXXXXX\",\n \"state\": \"MADHYA PRADESH\",\n \"district\": \"XXXXXXXXX\"\n },\n \"expiryDate\": \"30/06/2022\",\n \"status\": \"VALID\",\n \"nic_2Digit\": \"63-INFORMATION SERVICE ACTIVITIES\",\n \"nic_4Digit\": \"6312-WEB PORTALS\",\n \"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\"\n },\n \"responseKey\": \"success_udyog_aadhaar\",\n \"responseCode\": \"S00000\",\n \"requestTimestamp\": \"XXXXXXXXX\",\n \"responseTimestamp\": \"XXXXXXXXX\",\n \"decentroTxnId\": \"XXXXXXXXX\"\n}" }, "Success: UDYAM": { "value": "{\n \"decentroTxnId\": \"DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\n \"status\": \"SUCCESS\",\n \"responseCode\": \"S00000\",\n \"message\": \"Successfully fetched details for the given Udyam number.\",\n \"data\": {\n \"udyamNumber\": \"UDYAM-AA-00-0000000\",\n \"enterpriseName\": \"M/S XXXXX XXXXX\",\n \"organisationType\": \"Private Limited Company\",\n \"majorActivity\": \"Services\",\n \"gender\": \"Male\",\n \"socialCategory\": \"General\",\n \"incorporationDate\": \"DD/MM/YYYY\",\n \"commencementDate\": \"DD/MM/YYYY\",\n \"enterpriseOfficialAddress\": {\n \"flat\": \"XXXX\",\n \"building\": \"XXXXXXXXXXXXXXXXXXX\",\n \"village\": \"XXXXXXXXXXXX\",\n \"block\": \"-\",\n \"street\": \"XXXXXXXXXXXXXXXXXXX\",\n \"city\": \"XXXXXXXXXXXX\",\n \"state\": \"XXXXXXXXXXXX\",\n \"district\": \"BENGALURU (URBAN)\",\n \"mobile\": \"XX*****XXX\",\n \"email\": \"XXXXXXXXXXXXXXXXX\"\n },\n \"dic\": \"BANGALORE (URBAN)\",\n \"msmeDfo\": \"BANGALORE\",\n \"udyamRegistrationDate\": \"DD/MM/YYYY\",\n \"enterpriseType\": {\n \"serialNumber\": \"1\",\n \"dataYear\": \"2020-21\",\n \"classificationYear\": \"2022-23\",\n \"enterpriseType\": \"Micro\",\n \"classificationDate\": \"DD/MM/YYYY\"\n },\n \"unitLocationDetails\": {\n \"serialNumber\": \"1\",\n \"unitName\": \"XXXXXXXXXXXXXXXXX\",\n \"flat\": \"XXXX\",\n \"building\": \"XXXXXXXXXXXXXXXXXXX\",\n \"village\": \"XXXXXXXXXXXXXXXXXXX\",\n \"block\": \"\",\n \"road\": \"XXXXXXXXXXXXXXXXXXX\",\n \"city\": \"XXXXXXXXXXXX\",\n \"pin\": \"XXXXXX\",\n \"state\": \"KARNATAKA\",\n \"district\": \"BENGALURU (URBAN)\"\n },\n \"nationalIndustryClassificationCode\": {\n \"serialNumber\": \"1\",\n \"nic2Digit\": \"XX - Computer programming, consultancy and related activities\",\n \"nic4Digit\": \"XXXX - Other information technology and computer service activities\",\n \"nic5Digit\": \"XXXXX - Other information technology and computer service activities n.e.c\",\n \"activity\": \"Services\",\n \"date\": \"DD/MM/YYYY\"\n }\n },\n \"responseKey\": \"success_udyam\"\n}" }, "Success: FLLPIN": { "value": "{\n \"status\": \"SUCCESS\",\n \"kycStatus\": \"SUCCESS\",\n \"message\": \"KYC Details for FLLPIN retrieved successfully.\",\n \"kycResult\": {\n \"foreignCompanyMasterData\": {\n \"emailId\": \"xxxxx@xx.com\",\n \"foreignCompanyWithShareCapital\": \"NA\",\n \"registeredAddress\": \"XXXXXXXXXXXXXXXXX\",\n \"typeOfOffice\": \"Branch Office\",\n \"dateOfIncorporation\": \"24/04/2007\",\n \"countryOfIncorporation\": \"South Korea\",\n \"companyName\": \"XXXXXXXXXXX\",\n \"companyStatus\": \"Not Available for e-filing\",\n \"details\": \"NA\",\n \"fcrn \": \"XXXXXX\",\n \"descriptionOfMainDivision\": \"Computer and related activities\",\n \"mainDivisionOfBusinessActivityToBeCarriedOutInIndia\": \"72\"\n },\n \"charges\": [],\n \"directors\": [\n {\n \"endDate\": \"NA\",\n \"surrenderedDin\": \"NA\",\n \"dinOrPan\": \"XXXXXXXXXX\",\n \"beginDate\": \"06/08/2007\",\n \"name\": \"XXXXXXXXX\"\n }\n ]\n },\n \"responseKey\": \"success_fllpin\",\n \"responseCode\": \"S00000\",\n \"requestTimestamp\": \"2023-08-30 18:07:10.447335 IST (GMT +0530)\",\n \"responseTimestamp\": \"2023-08-30 18:07:18.567955 IST (GMT +0530)\",\n \"decentroTxnId\": \"DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\"\n}" }, "Success: DIN": { "value": "{\n \"status\": \"SUCCESS\",\n \"kycStatus\": \"SUCCESS\",\n \"message\": \"KYC Details for DIN retrieved successfully.\",\n \"kycResult\": {\n \"llpData\": [],\n \"companyData\": [\n {\n \"endDate\": \"NA\",\n \"activeCompliance\": \"ACTIVE Non-Compliant\",\n \"companyName\": \"XXXXXXXXXXXXXXXXX\",\n \"beginDate\": \"02/03/2017\",\n \"cinOrFcrn\": \"XXXXXXXXXXXXXXXXX\"\n }\n ],\n \"directorData\": {\n \"din\": \"XXXXXXXX\",\n \"name\": \"XXXXXXXXXXXXXXXXX\"\n }\n },\n \"responseKey\": \"success_din\",\n \"responseCode\": \"S00000\",\n \"requestTimestamp\": \"2023-08-30 18:14:42.317284 IST (GMT +0530)\",\n \"responseTimestamp\": \"2023-08-30 18:14:43.976432 IST (GMT +0530)\",\n \"decentroTxnId\": \"DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\"\n}" }, "Success: LLPIN": { "value": "{\n \"status\": \"SUCCESS\",\n \"kycStatus\": \"SUCCESS\",\n \"message\": \"KYC Details for LLPIN retrieved successfully.\",\n \"kycResult\": {\n \"charges\": [],\n \"directors\": [\n {\n \"endDate\": \"NA\",\n \"surrenderedDin\": \"NO\",\n \"dinOrPan\": \"XXXXXXX\",\n \"beginDate\": \"24/03/2015\",\n \"name\": \"XXXXXXXXXXXXX\"\n },\n {\n \"endDate\": \"NA\",\n \"surrenderedDin\": \"NO\",\n \"dinOrPan\": \"XXXXXXX\",\n \"beginDate\": \"24/03/2015\",\n \"name\": \"XXXXXXXXXXXXX\"\n }\n ],\n \"llpMasterData\": {\n \"emailId\": \"xxxxxxxxxx@xx.in\",\n \"registeredAddress\": \"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\n \"dateOfLastFinancialYearEndDateForWhichAnnualReturnFiled\": \"NA\",\n \"dateOfLastFinancialYearEndDateForWhichStatementOfAccountsAndSolvencyFiled\": \"NA\",\n \"mainDivisionOfBusinessActivityToBeCarriedOutInIndia\": \"74\",\n \"previousFircompanyDetailifApplicable\": \"NA\",\n \"rocCode\": \"RoC-Mumbai\",\n \"numberOfDesignatedPartners\": \"2\",\n \"dateOfIncorporation\": \"24/03/2015\",\n \"llpName\": \"XXXXXXXXXX LLP\",\n \"totalObligationOfContribution\": \"110000\",\n \"llpin \": \"XXXXXXX\",\n \"llpStatus\": \"Active\",\n \"descriptionOfMainDivision\": \"Other Business Activities\",\n \"numberOfPartners\": \"0\"\n }\n },\n \"responseKey\": \"success_llpin\",\n \"responseCode\": \"S00000\",\n \"requestTimestamp\": \"2023-08-30 18:11:08.841061 IST (GMT +0530)\",\n \"responseTimestamp\": \"2023-08-30 18:11:16.167331 IST (GMT +0530)\",\n \"decentroTxnId\": \"DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\"\n}" }, "Success: FCRN": { "value": "{\n \"status\": \"SUCCESS\",\n \"kycStatus\": \"SUCCESS\",\n \"message\": \"KYC Details for FCRN retrieved successfully.\",\n \"kycResult\": {\n \"charges\": [],\n \"directors\": [\n {\n \"endDate\": \"NA\",\n \"surrenderedDin\": \"NO\",\n \"dinOrPan\": \"XXXXXXXX\",\n \"beginDate\": \"24/03/2015\",\n \"name\": \"XXXXXXXX XXXXXXXX XXXXXXXX\"\n },\n {\n \"endDate\": \"NA\",\n \"surrenderedDin\": \"NO\",\n \"dinOrPan\": \"XXXXXXXX\",\n \"beginDate\": \"24/03/2015\",\n \"name\": \"XXXXXXXX XXXXXXXX XXXXXXXX\"\n }\n ],\n \"llpMasterData\": {\n \"emailId\": \"XXXXXXXX@XX.in\",\n \"registeredAddress\": \"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\n \"dateOfLastFinancialYearEndDateForWhichAnnualReturnFiled\": \"NA\",\n \"dateOfLastFinancialYearEndDateForWhichStatementOfAccountsAndSolvencyFiled\": \"NA\",\n \"mainDivisionOfBusinessActivityToBeCarriedOutInIndia\": \"74\",\n \"previousFircompanyDetailifApplicable\": \"NA\",\n \"rocCode\": \"RoC-Mumbai\",\n \"numberOfDesignatedPartners\": \"2\",\n \"dateOfIncorporation\": \"24/03/2015\",\n \"llpName\": \"XXXXXXXX LLP\",\n \"totalObligationOfContribution\": \"110000\",\n \"llpin \": \"XXXXXXX\",\n \"llpStatus\": \"Active\",\n \"descriptionOfMainDivision\": \"Other Business Activities\",\n \"numberOfPartners\": \"0\"\n }\n },\n \"responseKey\": \"success_fcrn\",\n \"responseCode\": \"S00000\",\n \"requestTimestamp\": \"2023-08-30 18:20:20.856513 IST (GMT +0530)\",\n \"responseTimestamp\": \"2023-08-30 18:20:22.123674 IST (GMT +0530)\",\n \"decentroTxnId\": \"DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\"\n}" } }, "schema": { "oneOf": [ { "title": "Success: Business PAN", "type": "object", "properties": { "kycStatus": { "type": "string", "example": "SUCCESS" }, "status": { "type": "string", "example": "SUCCESS" }, "message": { "type": "string", "example": "KYC Details for PAN retrieved successfully" }, "kycResult": { "type": "object", "properties": { "idNumber": { "type": "string", "example": "ABCDE12345" }, "idStatus": { "type": "string", "example": "VALID" }, "name": { "type": "string", "example": "AMAZON SELLER SERVICES PRIVATE LIMITED" } } }, "responseKey": { "type": "string", "example": "success_pan" }, "responseCode": { "type": "string", "example": "S00000" }, "requestTimestamp": { "type": "string", "example": "2020-07-24 21:25:20.778016 IST (GMT +0530)" }, "responseTimestamp": { "type": "string", "example": "2020-07-24 21:25:21.991470 IST (GMT +0530)" }, "decentroTxnId": { "type": "string", "example": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXX" } } }, { "title": "Success: No records found", "type": "object", "properties": { "status": { "type": "string", "example": "SUCCESS" }, "kycStatus": { "type": "string", "example": "FAILURE" }, "error": { "type": "object", "properties": { "message": { "type": "string", "example": "No records found for the given ID." }, "responseCode": { "type": "string", "example": "E00021" } } }, "responseKey": { "type": "string", "example": "error_invalid_pan" }, "requestTimestamp": { "type": "string", "example": "2023-03-20 15:03:40.178215 IST (GMT +0530)" }, "responseTimestamp": { "type": "string", "example": "2023-03-20 15:03:43.009710 IST (GMT +0530)" }, "decentroTxnId": { "type": "string", "example": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXX" } } }, { "title": "Success: GSTIN", "type": "object", "properties": { "kycStatus": { "type": "string", "example": "SUCCESS" }, "status": { "type": "string", "example": "SUCCESS" }, "message": { "type": "string", "example": "KYC Details for GSTIN retrived successfully." }, "kycResult": { "type": "object", "properties": { "gstin": { "type": "string", "example": "XXXXXXXXXXXXXX" }, "legalName": { "type": "string", "example": "XXXXXXXXXXXXXXXXXXXX" }, "stateJurisdiction": { "type": "string", "example": "LGSTO 045 - Bengaluru" }, "centralJurisdiction": { "type": "string", "example": "RANGE-AED2" }, "centralJurisdictionCode": { "type": "string", "example": "YT0201" }, "constitutionOfBusiness": { "type": "string", "example": "Private Limited Company" }, "taxpayerType": { "type": "string", "example": "Regular" }, "natureOfBusiness": { "type": "array", "items": { "type": "string", "example": "Export" } }, "natureOfCoreBusinessActivity": { "type": "string", "example": "Service Provider and Others" }, "gstnStatus": { "type": "string", "example": "Active" }, "tradeName": { "type": "string", "example": "XXXXXXXXXXXXXXXXX" }, "registrationDate": { "type": "string", "example": "04/09/2020" }, "principalPlaceOfBusiness": { "type": "string", "example": "Indiranagar, Bengaluru, Bengaluru Urban, Karnataka, 560038" }, "pan": { "type": "string", "example": "XXXXXXXXXX" }, "registrationType": { "type": "string", "example": "NORMAL COMPOSITE CASUAL" } } }, "responseKey": { "type": "string", "example": "success_gstin" }, "responseCode": { "type": "string", "example": "S00000" }, "requestTimestamp": { "type": "string", "example": "2024-06-09 17:42:21.078532 IST (GMT +0530)" }, "responseTimestamp": { "type": "string", "example": "2024-06-09 17:42:22.027391 IST (GMT +0530)" }, "decentroTxnId": { "type": "string", "example": "XXXXXXXXXX" } } }, { "title": "Success: GSTIN_DETAILED", "type": "object", "properties": { "kycStatus": { "type": "string", "example": "******" }, "status": { "type": "string", "example": "******" }, "message": { "type": "string", "example": "***********************************************" }, "kycResult": { "type": "object", "properties": { "gstin": { "type": "string", "example": "*******************" }, "legalName": { "type": "string", "example": "*******************************" }, "stateJurisdiction": { "type": "string", "example": "***********************" }, "centralJurisdiction": { "type": "string", "example": "************" }, "centralJurisdictionCode": { "type": "string", "example": "******" }, "constitutionOfBusiness": { "type": "string", "example": "***********************" }, "taxpayerType": { "type": "string", "example": "*******" }, "natureOfBusiness": { "type": "array", "items": { "type": "string", "example": "******" } }, "natureOfCoreBusinessActivity": { "type": "string", "example": "*****************************" }, "annualAggregateTurnover": { "type": "string", "example": "******" }, "gstnStatus": { "type": "string", "example": "******" }, "tradeName": { "type": "string", "example": "*******************************" }, "registrationDate": { "type": "string", "example": "**********" }, "principalPlaceOfBusiness": { "type": "string", "example": "********************************************" }, "pan": { "type": "string", "example": "***********" }, "registrationType": { "type": "string", "example": "****************************" }, "businessDetails": { "type": "array", "items": { "type": "object", "properties": { "hsn": { "type": "string", "example": "******" }, "type": { "type": "string", "example": "********" }, "description": { "type": "string", "example": "*******************************************************" } } } }, "filingStatus": { "type": "array", "items": { "type": "object", "properties": { "filingYear": { "type": "string", "example": "*********" }, "filingPeriod": { "type": "string", "example": "*****" }, "filingMethod": { "type": "string", "example": "******" }, "filingDate": { "type": "string", "example": "**********" }, "filingGstType": { "type": "string", "example": "******" }, "filingAnnualReturn": { "type": "string", "example": "**" }, "filingStatus": { "type": "string", "example": "*****" } } } }, "cinData": { "type": "object", "properties": { "charges": { "type": "array", "items": { "type": "object", "properties": {} } }, "directors": { "type": "array", "items": { "type": "object", "properties": { "endDate": { "type": "string", "example": "**" }, "dinOrPan": { "type": "string", "example": "********" }, "beginDate": { "type": "string", "example": "**********" }, "name": { "type": "string", "example": "************" } } } }, "companyMasterData": { "type": "object", "properties": { "companyCategory": { "type": "string", "example": "*******************************" }, "emailId": { "type": "string", "example": "*****************" }, "classOfCompany": { "type": "string", "example": "******" }, "numberOfMembersApplicableInCaseOfCompanyWithoutShareCapital": { "type": "string", "example": "**" }, "addressOtherThanRegisteredOfficeWhereAllOrAnyBooksOfAccountAndPapersAreMaintained": { "type": "string", "example": "**" }, "dateOfLastAgm": { "type": "string", "example": "**********" }, "registeredAddress": { "type": "string", "example": "****************************************************************" }, "registrationNumber": { "type": "string", "example": "*******" }, "paidUpCapitalInInr": { "type": "string", "example": "*******" }, "whetherListedOrNot": { "type": "string", "example": "********" }, "suspendedAtStockExchange": { "type": "string", "example": "**" }, "cin": { "type": "string", "example": "********************" }, "companySubcategory": { "type": "string", "example": "******************" }, "authorisedCapitalInInr": { "type": "string", "example": "********" }, "companyStatusForEFiling": { "type": "string", "example": "******" }, "rocCode": { "type": "string", "example": "*********" }, "dateOfBalanceSheet": { "type": "string", "example": "**********" }, "dateOfIncorporation": { "type": "string", "example": "**********" }, "companyName": { "type": "string", "example": "*******************************" }, "activeCompliance": { "type": "string", "example": "**" }, "mainDivisionOfBusinessActivityToBeCarriedOutInIndia": { "type": "string", "example": "**" }, "previousFircompanyDetailifApplicable": { "type": "string", "example": "**" }, "numberOfDesignatedPartners": { "type": "string", "example": "**" }, "totalObligationOfContribution": { "type": "string", "example": "*" }, "descriptionOfMainDivision": { "type": "string", "example": "*********************************************************" }, "numberOfPartners": { "type": "string", "example": "**" } } } } }, "pdf": { "type": "string", "example": "********************************************" } } }, "responseKey": { "type": "string", "example": "*************" }, "responseCode": { "type": "string", "example": "******" }, "requestTimestamp": { "type": "string", "example": "*****************************************" }, "responseTimestamp": { "type": "string", "example": "*****************************************" }, "decentroTxnId": { "type": "string", "example": "*************************************" } } }, { "title": "Success: CIN", "type": "object", "properties": { "status": { "type": "string", "example": "SUCCESS" }, "kycStatus": { "type": "string", "example": "SUCCESS" }, "message": { "type": "string", "example": "KYC Details for CIN retrieved successfully." }, "kycResult": { "type": "object", "properties": { "companyMasterData": { "type": "object", "properties": { "companyCategory": { "type": "string", "example": "Company limited by Shares" }, "emailId": { "type": "string", "example": "xxxxxx@xxxxxxxxxxx.com" }, "classOfCompany": { "type": "string", "example": "Private" }, "numberOfMembersApplicableInCaseOfCompanyWithoutShareCapital": { "type": "string", "example": "0" }, "addressOtherThanRegisteredOfficeWhereAllOrAnyBooksOfAccountAndPapersAreMaintained": { "type": "string", "example": "NA" }, "dateOfLastAgm": { "type": "string", "example": "DD/MM/YYYY" }, "registeredAddress": { "type": "string", "example": "xxxxxxxxxxxxxxxx" }, "activeCompliance": { "type": "string", "example": "ACTIVE compliant" }, "registrationNumber": { "type": "string", "example": "xxxxxx" }, "paidUpCapitalInInr": { "type": "string", "example": "100000" }, "whetherListedOrNot": { "type": "string", "example": "Unlisted" }, "suspendedAtStockExchange": { "type": "string", "example": "NA" }, "companySubcategory": { "type": "string", "example": "Non-govt company" }, "authorisedCapitalInInr": { "type": "string", "example": "100000" }, "companyStatusForEFiling": { "type": "string", "example": "Active" }, "rocCode": { "type": "string", "example": "RoC-Chennai" }, "dateOfBalanceSheet": { "type": "string", "example": "DD/MM/YYYY" }, "dateOfIncorporation": { "type": "string", "example": "DD/MM/YYYY" }, "cin ": { "type": "string", "example": "xxxxxxxxxxxxxxxxxxxx" }, "companyName": { "type": "string", "example": "xxxxxxxxxxxxxxxxxxxxxx" } } }, "charges": { "type": "array", "items": { "type": "object", "properties": {} } }, "directors": { "type": "array", "items": { "type": "object", "properties": { "endDate": { "type": "string", "example": "NA" }, "surrenderedDin": { "type": "string", "example": "NA" }, "dinOrPan": { "type": "string", "example": "xxxxxxxx" }, "beginDate": { "type": "string", "example": "DD/MM/YYYY" }, "name": { "type": "string", "example": "xxxxxx xxxxxxx" } } } } } }, "responseKey": { "type": "string", "example": "success_cin" }, "responseCode": { "type": "string", "example": "S00000" }, "requestTimestamp": { "type": "string", "example": "2023-05-18 13:21:48.887661 IST (GMT +0530)" }, "responseTimestamp": { "type": "string", "example": "2023-05-18 13:21:49.806250 IST (GMT +0530)" }, "decentroTxnId": { "type": "string", "example": "DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" } } }, { "title": "Success: FSSAI", "type": "object", "properties": { "kycStatus": { "type": "string", "example": "SUCCESS" }, "kycResult": { "type": "object", "properties": { "idNumber": { "type": "string", "example": "11111111111111" }, "licenseType": { "type": "string", "example": "REGISTRATION" }, "entityName": { "type": "string", "example": "NAME" }, "status": { "type": "string", "example": "ACTIVE" }, "premissesAddress": { "type": "object", "properties": { "district": { "type": "string", "example": "" }, "address": { "type": "string", "example": "Some Address Line" }, "state": { "type": "string", "example": "WEST BENGAL" }, "pincode": { "type": "string", "example": "XXXXXX" } } }, "products": { "type": "array", "items": { "type": "object", "properties": { "slNo": { "type": "string", "example": "2" }, "foodProductCategory": { "type": "string", "example": "02 - Product Category Name" } } } }, "address": { "type": "object", "properties": { "district": { "type": "array", "items": { "type": "string", "example": "EAST MIDNAPORE" } }, "state": { "type": "array", "items": { "type": "array", "items": { "type": "string", "example": "WEST BENGAL" } } }, "city": { "type": "array", "items": { "type": "string", "example": "KHANJANCHAK" } }, "pincode": { "type": "string", "example": "XXXXXX" }, "country": { "type": "array", "items": { "type": "string", "example": "IN" } }, "addressLine": { "type": "string", "example": "Some Address Line" } } } } }, "responseKey": { "type": "string", "example": "success_fssai" }, "responseCode": { "type": "string", "example": "S00000" }, "requestTimestamp": { "type": "string", "example": "2023-01-13 14:57:22.932451 IST (GMT +0530)" }, "responseTimestamp": { "type": "string", "example": "2023-01-13 14:57:23.866098 IST (GMT +0530)" }, "decentroTxnId": { "type": "string", "example": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXX" } } }, { "title": "Success: UDYOG_AADHAAR", "type": "object", "properties": { "status": { "type": "string", "example": "SUCCESS" }, "kycStatus": { "type": "string", "example": "SUCCESS" }, "message": { "type": "string", "example": "KYC Details for Udyog Aadhaar retrieved successfully." }, "kycResult": { "type": "object", "properties": { "uamNumber": { "type": "string", "example": "XXXXXXXXX" }, "enterpriseName": { "type": "string", "example": "ABC ONLINE AND PHOTOCOPY" }, "majorActivity": { "type": "string", "example": "SERVICES" }, "socialCategory": { "type": "string", "example": "OBC" }, "enterpriseType": { "type": "string", "example": "MICRO" }, "mobile": { "type": "string", "example": "89*****168" }, "email": { "type": "string", "example": "NE******14@GMAIL.COM" }, "dateOfCommencement": { "type": "string", "example": "22/10/2018" }, "dicName": { "type": "string", "example": "VIDISHA" }, "state": { "type": "string", "example": "MADHYA PRADESH" }, "appliedDate": { "type": "string", "example": "12/12/2018" }, "modifiedDate": { "type": "string", "example": "N/A" }, "address": { "type": "object", "properties": { "serialNumber": { "type": "string", "example": "1" }, "flatDoorBlockNumber": { "type": "string", "example": "XXXXXXXXX" }, "nameOfPremisesBuildingVillage": { "type": "string", "example": "XXXXXXXXX" }, "roadStreetLane": { "type": "string", "example": "XXXXXXXXX" }, "areaLocality": { "type": "string", "example": "XXXXXXXXX" }, "city": { "type": "string", "example": "XXXXXXXXX" }, "pin": { "type": "string", "example": "XXXXXXXXX" }, "state": { "type": "string", "example": "MADHYA PRADESH" }, "district": { "type": "string", "example": "XXXXXXXXX" } } }, "expiryDate": { "type": "string", "example": "30/06/2022" }, "status": { "type": "string", "example": "VALID" }, "nic_2Digit": { "type": "string", "example": "63-INFORMATION SERVICE ACTIVITIES" }, "nic_4Digit": { "type": "string", "example": "6312-WEB PORTALS" }, "nic_5Digit": { "type": "string", "example": "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": { "type": "string", "example": "success_udyog_aadhaar" }, "responseCode": { "type": "string", "example": "S00000" }, "requestTimestamp": { "type": "string", "example": "XXXXXXXXX" }, "responseTimestamp": { "type": "string", "example": "XXXXXXXXX" }, "decentroTxnId": { "type": "string", "example": "XXXXXXXXX" } } }, { "title": "Success: UDYAM", "type": "object", "properties": { "decentroTxnId": { "type": "string", "example": "DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" }, "status": { "type": "string", "example": "SUCCESS" }, "responseCode": { "type": "string", "example": "S00000" }, "message": { "type": "string", "example": "Successfully fetched details for the given Udyam number." }, "data": { "type": "object", "properties": { "udyamNumber": { "type": "string", "example": "UDYAM-AA-00-0000000" }, "enterpriseName": { "type": "string", "example": "M/S XXXXX XXXXX" }, "organisationType": { "type": "string", "example": "Private Limited Company" }, "majorActivity": { "type": "string", "example": "Services" }, "gender": { "type": "string", "example": "Male" }, "socialCategory": { "type": "string", "example": "General" }, "incorporationDate": { "type": "string", "example": "DD/MM/YYYY" }, "commencementDate": { "type": "string", "example": "DD/MM/YYYY" }, "enterpriseOfficialAddress": { "type": "object", "properties": { "flat": { "type": "string", "example": "XXXX" }, "building": { "type": "string", "example": "XXXXXXXXXXXXXXXXXXX" }, "village": { "type": "string", "example": "XXXXXXXXXXXX" }, "block": { "type": "string", "example": "-" }, "street": { "type": "string", "example": "XXXXXXXXXXXXXXXXXXX" }, "city": { "type": "string", "example": "XXXXXXXXXXXX" }, "state": { "type": "string", "example": "XXXXXXXXXXXX" }, "district": { "type": "string", "example": "BENGALURU (URBAN)" }, "mobile": { "type": "string", "example": "XX*****XXX" }, "email": { "type": "string", "example": "XXXXXXXXXXXXXXXXX" } } }, "dic": { "type": "string", "example": "BANGALORE (URBAN)" }, "msmeDfo": { "type": "string", "example": "BANGALORE" }, "udyamRegistrationDate": { "type": "string", "example": "DD/MM/YYYY" }, "enterpriseType": { "type": "object", "properties": { "serialNumber": { "type": "string", "example": "1" }, "dataYear": { "type": "string", "example": "2020-21" }, "classificationYear": { "type": "string", "example": "2022-23" }, "enterpriseType": { "type": "string", "example": "Micro" }, "classificationDate": { "type": "string", "example": "DD/MM/YYYY" } } }, "unitLocationDetails": { "type": "object", "properties": { "serialNumber": { "type": "string", "example": "1" }, "unitName": { "type": "string", "example": "XXXXXXXXXXXXXXXXX" }, "flat": { "type": "string", "example": "XXXX" }, "building": { "type": "string", "example": "XXXXXXXXXXXXXXXXXXX" }, "village": { "type": "string", "example": "XXXXXXXXXXXXXXXXXXX" }, "block": { "type": "string", "example": "" }, "road": { "type": "string", "example": "XXXXXXXXXXXXXXXXXXX" }, "city": { "type": "string", "example": "XXXXXXXXXXXX" }, "pin": { "type": "string", "example": "XXXXXX" }, "state": { "type": "string", "example": "KARNATAKA" }, "district": { "type": "string", "example": "BENGALURU (URBAN)" } } }, "nationalIndustryClassificationCode": { "type": "object", "properties": { "serialNumber": { "type": "string", "example": "1" }, "nic2Digit": { "type": "string", "example": "XX - Computer programming, consultancy and related activities" }, "nic4Digit": { "type": "string", "example": "XXXX - Other information technology and computer service activities" }, "nic5Digit": { "type": "string", "example": "XXXXX - Other information technology and computer service activities n.e.c" }, "activity": { "type": "string", "example": "Services" }, "date": { "type": "string", "example": "DD/MM/YYYY" } } } } }, "responseKey": { "type": "string", "example": "success_udyam" } } }, { "title": "Success: FLLPIN", "type": "object", "properties": { "status": { "type": "string", "example": "SUCCESS" }, "kycStatus": { "type": "string", "example": "SUCCESS" }, "message": { "type": "string", "example": "KYC Details for FLLPIN retrieved successfully." }, "kycResult": { "type": "object", "properties": { "foreignCompanyMasterData": { "type": "object", "properties": { "emailId": { "type": "string", "example": "xxxxx@xx.com" }, "foreignCompanyWithShareCapital": { "type": "string", "example": "NA" }, "registeredAddress": { "type": "string", "example": "XXXXXXXXXXXXXXXXX" }, "typeOfOffice": { "type": "string", "example": "Branch Office" }, "dateOfIncorporation": { "type": "string", "example": "24/04/2007" }, "countryOfIncorporation": { "type": "string", "example": "South Korea" }, "companyName": { "type": "string", "example": "XXXXXXXXXXX" }, "companyStatus": { "type": "string", "example": "Not Available for e-filing" }, "details": { "type": "string", "example": "NA" }, "fcrn ": { "type": "string", "example": "XXXXXX" }, "descriptionOfMainDivision": { "type": "string", "example": "Computer and related activities" }, "mainDivisionOfBusinessActivityToBeCarriedOutInIndia": { "type": "string", "example": "72" } } }, "charges": { "type": "array", "items": { "type": "object", "properties": {} } }, "directors": { "type": "array", "items": { "type": "object", "properties": { "endDate": { "type": "string", "example": "NA" }, "surrenderedDin": { "type": "string", "example": "NA" }, "dinOrPan": { "type": "string", "example": "XXXXXXXXXX" }, "beginDate": { "type": "string", "example": "06/08/2007" }, "name": { "type": "string", "example": "XXXXXXXXX" } } } } } }, "responseKey": { "type": "string", "example": "success_fllpin" }, "responseCode": { "type": "string", "example": "S00000" }, "requestTimestamp": { "type": "string", "example": "2023-08-30 18:07:10.447335 IST (GMT +0530)" }, "responseTimestamp": { "type": "string", "example": "2023-08-30 18:07:18.567955 IST (GMT +0530)" }, "decentroTxnId": { "type": "string", "example": "DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" } } }, { "title": "Success: DIN", "type": "object", "properties": { "status": { "type": "string", "example": "SUCCESS" }, "kycStatus": { "type": "string", "example": "SUCCESS" }, "message": { "type": "string", "example": "KYC Details for DIN retrieved successfully." }, "kycResult": { "type": "object", "properties": { "llpData": { "type": "array", "items": { "type": "object", "properties": {} } }, "companyData": { "type": "array", "items": { "type": "object", "properties": { "endDate": { "type": "string", "example": "NA" }, "activeCompliance": { "type": "string", "example": "ACTIVE Non-Compliant" }, "companyName": { "type": "string", "example": "XXXXXXXXXXXXXXXXX" }, "beginDate": { "type": "string", "example": "02/03/2017" }, "cinOrFcrn": { "type": "string", "example": "XXXXXXXXXXXXXXXXX" } } } }, "directorData": { "type": "object", "properties": { "din": { "type": "string", "example": "XXXXXXXX" }, "name": { "type": "string", "example": "XXXXXXXXXXXXXXXXX" } } } } }, "responseKey": { "type": "string", "example": "success_din" }, "responseCode": { "type": "string", "example": "S00000" }, "requestTimestamp": { "type": "string", "example": "2023-08-30 18:14:42.317284 IST (GMT +0530)" }, "responseTimestamp": { "type": "string", "example": "2023-08-30 18:14:43.976432 IST (GMT +0530)" }, "decentroTxnId": { "type": "string", "example": "DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" } } }, { "title": "Success: LLPIN", "type": "object", "properties": { "status": { "type": "string", "example": "SUCCESS" }, "kycStatus": { "type": "string", "example": "SUCCESS" }, "message": { "type": "string", "example": "KYC Details for LLPIN retrieved successfully." }, "kycResult": { "type": "object", "properties": { "charges": { "type": "array", "items": { "type": "object", "properties": {} } }, "directors": { "type": "array", "items": { "type": "object", "properties": { "endDate": { "type": "string", "example": "NA" }, "surrenderedDin": { "type": "string", "example": "NO" }, "dinOrPan": { "type": "string", "example": "XXXXXXX" }, "beginDate": { "type": "string", "example": "24/03/2015" }, "name": { "type": "string", "example": "XXXXXXXXXXXXX" } } } }, "llpMasterData": { "type": "object", "properties": { "emailId": { "type": "string", "example": "xxxxxxxxxx@xx.in" }, "registeredAddress": { "type": "string", "example": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" }, "dateOfLastFinancialYearEndDateForWhichAnnualReturnFiled": { "type": "string", "example": "NA" }, "dateOfLastFinancialYearEndDateForWhichStatementOfAccountsAndSolvencyFiled": { "type": "string", "example": "NA" }, "mainDivisionOfBusinessActivityToBeCarriedOutInIndia": { "type": "string", "example": "74" }, "previousFircompanyDetailifApplicable": { "type": "string", "example": "NA" }, "rocCode": { "type": "string", "example": "RoC-Mumbai" }, "numberOfDesignatedPartners": { "type": "string", "example": "2" }, "dateOfIncorporation": { "type": "string", "example": "24/03/2015" }, "llpName": { "type": "string", "example": "XXXXXXXXXX LLP" }, "totalObligationOfContribution": { "type": "string", "example": "110000" }, "llpin ": { "type": "string", "example": "XXXXXXX" }, "llpStatus": { "type": "string", "example": "Active" }, "descriptionOfMainDivision": { "type": "string", "example": "Other Business Activities" }, "numberOfPartners": { "type": "string", "example": "0" } } } } }, "responseKey": { "type": "string", "example": "success_llpin" }, "responseCode": { "type": "string", "example": "S00000" }, "requestTimestamp": { "type": "string", "example": "2023-08-30 18:11:08.841061 IST (GMT +0530)" }, "responseTimestamp": { "type": "string", "example": "2023-08-30 18:11:16.167331 IST (GMT +0530)" }, "decentroTxnId": { "type": "string", "example": "DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" } } }, { "title": "Success: FCRN", "type": "object", "properties": { "status": { "type": "string", "example": "SUCCESS" }, "kycStatus": { "type": "string", "example": "SUCCESS" }, "message": { "type": "string", "example": "KYC Details for FCRN retrieved successfully." }, "kycResult": { "type": "object", "properties": { "charges": { "type": "array", "items": { "type": "object", "properties": {} } }, "directors": { "type": "array", "items": { "type": "object", "properties": { "endDate": { "type": "string", "example": "NA" }, "surrenderedDin": { "type": "string", "example": "NO" }, "dinOrPan": { "type": "string", "example": "XXXXXXXX" }, "beginDate": { "type": "string", "example": "24/03/2015" }, "name": { "type": "string", "example": "XXXXXXXX XXXXXXXX XXXXXXXX" } } } }, "llpMasterData": { "type": "object", "properties": { "emailId": { "type": "string", "example": "XXXXXXXX@XX.in" }, "registeredAddress": { "type": "string", "example": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" }, "dateOfLastFinancialYearEndDateForWhichAnnualReturnFiled": { "type": "string", "example": "NA" }, "dateOfLastFinancialYearEndDateForWhichStatementOfAccountsAndSolvencyFiled": { "type": "string", "example": "NA" }, "mainDivisionOfBusinessActivityToBeCarriedOutInIndia": { "type": "string", "example": "74" }, "previousFircompanyDetailifApplicable": { "type": "string", "example": "NA" }, "rocCode": { "type": "string", "example": "RoC-Mumbai" }, "numberOfDesignatedPartners": { "type": "string", "example": "2" }, "dateOfIncorporation": { "type": "string", "example": "24/03/2015" }, "llpName": { "type": "string", "example": "XXXXXXXX LLP" }, "totalObligationOfContribution": { "type": "string", "example": "110000" }, "llpin ": { "type": "string", "example": "XXXXXXX" }, "llpStatus": { "type": "string", "example": "Active" }, "descriptionOfMainDivision": { "type": "string", "example": "Other Business Activities" }, "numberOfPartners": { "type": "string", "example": "0" } } } } }, "responseKey": { "type": "string", "example": "success_fcrn" }, "responseCode": { "type": "string", "example": "S00000" }, "requestTimestamp": { "type": "string", "example": "2023-08-30 18:20:20.856513 IST (GMT +0530)" }, "responseTimestamp": { "type": "string", "example": "2023-08-30 18:20:22.123674 IST (GMT +0530)" }, "decentroTxnId": { "type": "string", "example": "DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" } } } ] } } } }, "400": { "description": "400", "content": { "application/json": { "examples": { "Failure: Invalid Document": { "value": "{\n \"status\": \"FAILURE\",\n \"kycStatus\": \"FAILURE\",\n \"error\": {\n \"message\": \"Invalid PAN. PAN should be of 10 characters where first five characters are letters, next four numeral and last character is a letter.\",\n \"responseCode\": \"E00021\"\n },\n \"responseKey\": \"error_invalid_pan\",\n \"requestTimestamp\": \"2023-03-20 15:07:27.320523 IST (GMT +0530)\",\n \"responseTimestamp\": \"2023-03-20 15:07:27.382024 IST (GMT +0530)\",\n \"decentroTxnId\": \"DECXXXXXXXXXXXXXXXXXXXXXXXXXXX\"\n}" }, "Failure: Empty Reference ID": { "value": "{\n \"decentroTxnId\": \"DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\n \"status\": \"FAILURE\",\n \"responseCode\": \"E00009\",\n \"message\": \"Request reference ID cannot be null or empty. Hint: reference_id (string)\",\n \"responseKey\": \"error_empty_reference_id\"\n}" }, "Failure: False Consent": { "value": "{\n \"status\": \"FAILURE\",\n \"kycStatus\": \"UNKNOWN\",\n \"error\": {\n \"message\": \"Validation cannot be processed without user consent.\",\n \"responseCode\": \"E00009\"\n },\n \"responseKey\": \"error_consent_false\",\n \"requestTimestamp\": \"2023-03-30 15:06:55.097463 IST (GMT +0530)\",\n \"responseTimestamp\": \"2023-03-30 15:06:55.111230 IST (GMT +0530)\",\n \"decentroTxnId\": \"DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\"\n}" }, "Failure: Empty Purpose": { "value": "{\n \"status\": \"FAILURE\",\n \"kycStatus\": \"UNKNOWN\",\n \"error\": {\n \"message\": \"Consent purpose cannot be empty. Hint: consent_purpose (string).\",\n \"responseCode\": \"E00009\"\n },\n \"responseKey\": \"error_empty_purpose\",\n \"requestTimestamp\": \"2023-03-30 15:09:17.834611 IST (GMT +0530)\",\n \"responseTimestamp\": \"2023-03-30 15:09:17.855323 IST (GMT +0530)\",\n \"decentroTxnId\": \"DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\"\n}" }, "Failure: Short Purpose Length": { "value": "{\n \"status\": \"FAILURE\",\n \"kycStatus\": \"UNKNOWN\",\n \"error\": {\n \"message\": \"Consent purpose should be at least 20 characters in length.\",\n \"responseCode\": \"E00009\"\n },\n \"responseKey\": \"error_short_purpose_length\",\n \"requestTimestamp\": \"2023-03-30 15:09:59.054631 IST (GMT +0530)\",\n \"responseTimestamp\": \"2023-03-30 15:09:59.070772 IST (GMT +0530)\",\n \"decentroTxnId\": \"DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\"\n}" } }, "schema": { "oneOf": [ { "title": "Failure: Invalid Document", "type": "object", "properties": { "status": { "type": "string", "example": "FAILURE" }, "kycStatus": { "type": "string", "example": "FAILURE" }, "error": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid PAN. PAN should be of 10 characters where first five characters are letters, next four numeral and last character is a letter." }, "responseCode": { "type": "string", "example": "E00021" } } }, "responseKey": { "type": "string", "example": "error_invalid_pan" }, "requestTimestamp": { "type": "string", "example": "2023-03-20 15:07:27.320523 IST (GMT +0530)" }, "responseTimestamp": { "type": "string", "example": "2023-03-20 15:07:27.382024 IST (GMT +0530)" }, "decentroTxnId": { "type": "string", "example": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXX" } } }, { "title": "Failure: Empty Reference ID", "type": "object", "properties": { "decentroTxnId": { "type": "string", "example": "DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" }, "status": { "type": "string", "example": "FAILURE" }, "responseCode": { "type": "string", "example": "E00009" }, "message": { "type": "string", "example": "Request reference ID cannot be null or empty. Hint: reference_id (string)" }, "responseKey": { "type": "string", "example": "error_empty_reference_id" } } }, { "title": "Failure: False Consent", "type": "object", "properties": { "status": { "type": "string", "example": "FAILURE" }, "kycStatus": { "type": "string", "example": "UNKNOWN" }, "error": { "type": "object", "properties": { "message": { "type": "string", "example": "Validation cannot be processed without user consent." }, "responseCode": { "type": "string", "example": "E00009" } } }, "responseKey": { "type": "string", "example": "error_consent_false" }, "requestTimestamp": { "type": "string", "example": "2023-03-30 15:06:55.097463 IST (GMT +0530)" }, "responseTimestamp": { "type": "string", "example": "2023-03-30 15:06:55.111230 IST (GMT +0530)" }, "decentroTxnId": { "type": "string", "example": "DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" } } }, { "title": "Failure: Empty Purpose", "type": "object", "properties": { "status": { "type": "string", "example": "FAILURE" }, "kycStatus": { "type": "string", "example": "UNKNOWN" }, "error": { "type": "object", "properties": { "message": { "type": "string", "example": "Consent purpose cannot be empty. Hint: consent_purpose (string)." }, "responseCode": { "type": "string", "example": "E00009" } } }, "responseKey": { "type": "string", "example": "error_empty_purpose" }, "requestTimestamp": { "type": "string", "example": "2023-03-30 15:09:17.834611 IST (GMT +0530)" }, "responseTimestamp": { "type": "string", "example": "2023-03-30 15:09:17.855323 IST (GMT +0530)" }, "decentroTxnId": { "type": "string", "example": "DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" } } }, { "title": "Failure: Short Purpose Length", "type": "object", "properties": { "status": { "type": "string", "example": "FAILURE" }, "kycStatus": { "type": "string", "example": "UNKNOWN" }, "error": { "type": "object", "properties": { "message": { "type": "string", "example": "Consent purpose should be at least 20 characters in length." }, "responseCode": { "type": "string", "example": "E00009" } } }, "responseKey": { "type": "string", "example": "error_short_purpose_length" }, "requestTimestamp": { "type": "string", "example": "2023-03-30 15:09:59.054631 IST (GMT +0530)" }, "responseTimestamp": { "type": "string", "example": "2023-03-30 15:09:59.070772 IST (GMT +0530)" }, "decentroTxnId": { "type": "string", "example": "DXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" } } } ] } } } }, "422": { "description": "422", "content": { "application/json": { "examples": { "Failure: Source Down": { "value": "{\n \"status\": \"FAILURE\",\n \"kycStatus\": \"UNKNOWN\",\n \"error\": {\n \"message\": \"Unexpected response received from the underlying data source / repository. It may be having a downtime. Please try again in some time and check our email / status alerts.\",\n \"responseCode\": \"E00045\"\n },\n \"responseKey\": \"error_provider_error\",\n \"requestTimestamp\": \"2026-05-14 18:39:37.280556 IST (GMT +0530)\",\n \"responseTimestamp\": \"2026-05-14 18:39:41.035760 IST (GMT +0530)\",\n \"decentroTxnId\": \"445A74C7CD444A9A810F8C9AD01259E3\"\n}" } }, "schema": { "type": "object", "properties": { "status": { "type": "string", "example": "FAILURE" }, "kycStatus": { "type": "string", "example": "UNKNOWN" }, "error": { "type": "object", "properties": { "message": { "type": "string", "example": "Unexpected response received from the underlying data source / repository. It may be having a downtime. Please try again in some time and check our email / status alerts." }, "responseCode": { "type": "string", "example": "E00045" } } }, "responseKey": { "type": "string", "example": "error_provider_error" }, "requestTimestamp": { "type": "string", "example": "2026-05-14 18:39:37.280556 IST (GMT +0530)" }, "responseTimestamp": { "type": "string", "example": "2026-05-14 18:39:41.035760 IST (GMT +0530)" }, "decentroTxnId": { "type": "string", "example": "445A74C7CD444A9A810F8C9AD01259E3" } } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true, "_id": "627cbd56949a61004bbb9c80:6605168fc91cec0058d5237a" } ```