Fetch By CIN Realtime
3 min
Introduction
This API allows you to fetch real-time company consolidated data for a given patron.
Sample CURL
curl --request POST \
--url https://signzy.tech/api/v2/patrons/...patronID.../companyconsolidated \
--header 'Accept: */*' \
--header 'Accept-Language: en-US,en;q=0.8' \
--header 'Authorization: <Access-Token>' \
--header 'content-type: application/json' \
--data '{"task":"fetchRealtime","essentials":{"cin":"...cin...", "callbackUrl":"...callbackUrl..."}}'Parameter | Description |
|---|---|
patronID | The unique identifier of the patron for whom you want to fetch the real-time company consolidated data. |
Access-Token | The access token generated by the API to authenticate the user. |
cin | The Corporate Identity Number of the company for which you want to fetch the data. |
callbackUrl | The URL where the API should send the response after processing the request. |
Sample API Response
{
"result": {
"companyData": {
"authorizedCapital": "...authorizedCapital...",
"cin": "...cin...",
"efilingStatus": "...efilingStatus...",
"dateOfIncorporation": "...dateOfIncorporation...",
"legalName": "...legalName...",
"companyName": "...companyName...",
"paidUpCapital": "...paidUpCapital...",
"sumOfCharges": "...sumOfCharges...",
"registeredAddress": {
"addressLine1": "...addressLine1...",
"addressLine2": "...addressLine2...",
"city": "...city...",
"pincode": "...pincode...",
"state": "...state..."
},
"businessAddress": {
"addressLine1": "...addressLine1...",
"addressLine2": "...addressLine2...",
"city": "...city...",
"pincode": "...pincode...",
"state": "...state..."
},
"pan": "...pan...",
"classification": "...classification...",
"status": "...status...",
"nextCin": "...nextCin...",
"lastAgmDate": "...lastAgmDate...",
"lastFilingDate": "...lastFilingDate...",
"email": "...email...",
"authorizedSignatories": [{
"pan": "...pan...",
"din": "...din...",
"name": "...name...",
"designation": "...designation...",
"dateOfBirth": "...dateOfBirth...",
"age": "...age...",
"dateOfAppointment": "...dateOfAppointment...",
"dateOfAppointmentForCurrentDesignation": "...dateOfAppointmentForCurrentDesignation...",
"dateOfCessation": "...dateOfCessation..."
}],
"charges": "...list of charges...",
"auditors": [{
"year": "...year...",
"auditorName": "...auditorName...",
"auditorFirmName": "...auditorFirmName...",
"pan": "...pan...",
"membershipNumber": "...membershipNumber...",
"firmRegistrationNumber": "...firmRegistrationNumber...",
"address": "...address..."
}],
"detailedFinancials": [{
"year": "...year...",
"nature": "...nature...",
"statedOn": "...statedOn...",
"filingStandard": "...filingStandard...",
"bs": {
"assets": {
"tangibleAssets": "...tangibleAssets...",
"producingProperties": "...producingProperties...",
"intangibleAssets": "...intangibleAssets...",
"preproducingProperties": "...preproducingProperties...",
"tangibleAssetsCapitalWorkInProgress": "...tangibleAssetsCapitalWorkInProgress...",
"intangibleAssetsUnderDevelopment": "...intangibleAssetsUnderDevelopment...",
"noncurrentInvestments": "...noncurrentInvestments...",
"deferredTaxAssetsNet": "...deferredTaxAssetsNet...",
"foreignCurrMonetaryItemTransDiffAssetAccount": "...foreignCurrMonetaryItemTransDiffAssetAccount...",
"longTermLoansAndAdvances": "...longTermLoansAndAdvances...",
"otherNoncurrentAssets": "...otherNoncurrentAssets...",
"currentInvestments": "...currentInvestments...",
"inventories": "...inventories...",
"tradeReceivables": "...tradeReceivables...",
"cashAndBankBalances": "...cashAndBankBalances...",
"shortTermLoansAndAdvances": "...shortTermLoansAndAdvances...",
"otherCurrentAssets": "...otherCurrentAssets...",
"givenAssetsTotal": "...givenAssetsTotal..."
},
"liabilities": {
"shareCapital": "...shareCapital...",
"reservesAndSurplus": "...reservesAndSurplus...",
"moneyReceivedAgainstShareWarrants": "...moneyReceivedAgainstShareWarrants...",
"shareApplicationMoneyPendingAllotment": "...shareApplicationMoneyPendingAllotment...",
"deferredGovernmentGrants": "...deferredGovernmentGrants...",
"minorityInterest": "...minorityInterest...",
"longTermBorrowings": "...longTermBorrowings...",
"deferredTaxLiabilitiesNet": "...deferredTaxLiabilitiesNet...",
"foreignCurrMonetaryItemTransDiffLiabilityAccount": "...foreignCurrMonetaryItemTransDiffLiabilityAccount...",
"otherLongTermLiabilities": "...otherLongTermLiabilities...",
"longTermProvisions": "...longTermProvisions...",
"shortTermBorrowings": "...shortTermBorrowings...",
"tradePayables": "...tradePayables...",
"otherCurrentLiabilities": "...otherCurrentLiabilities...",
"shortTermProvisions": "...shortTermProvisions...",
"givenLiabilities_total": "...givenLiabilities_total...",
"givenLiabilitiesTotal": "...givenLiabilitiesTotal..."
},
"subTotals": {
"totalEquity": "...totalEquity...",
"totalCurrentLiabilities": "...totalCurrentLiabilities...",
"netFixedAssets": "...netFixedAssets...",
"totalCurrentAssets": "...totalCurrentAssets...",
"capitalWip": "...capitalWip...",
"totalDebt": "...totalDebt..."
},
"metadata": {
"fileName": "...fileName...",
"fileURL": "...fileURL..."
}
},
"pnl": {
"lineItems": {
"netRevenue": "...netRevenue...",
"totalCostOfMaterialsConsumed": "...totalCostOfMaterialsConsumed...",
"totalPurchasesOfStockInTrade": "...totalPurchasesOfStockInTrade...",
"totalChangesInInventoriesOrFinishedGoods": "...totalChangesInInventoriesOrFinishedGoods...",
"totalEmployeeBenefitExpense": "...totalEmployeeBenefitExpense...",
"totalOtherExpenses": "...totalOtherExpenses...",
"operatingProfit": "...operatingProfit...",
"otherIncome": "...otherIncome...",
"depreciation": "...depreciation...",
"profitBeforeInterestAndTax": "...profitBeforeInterestAndTax...",
"interest": "...interest...",
"profitBeforeTaxAndExceptionalItemsBeforeTax": "...profitBeforeTaxAndExceptionalItemsBeforeTax...",
"exceptionalItemsBeforeTax": "...exceptionalItemsBeforeTax...",
"profitBeforeTax": "...profitBeforeTax...",
"incomeTax": "...incomeTax...",
"profitForPeriodFromContinuingOperations": "...profitForPeriodFromContinuingOperations...",
"profitFromDiscontinuingOperationAfterTax": "...profitFromDiscontinuingOperationAfterTax...",
"minorityInterestAndProfitFromAssociatesAndJointVentures": "...minorityInterestAndProfitFromAssociatesAndJointVentures...",
"profitAfterTax": "...profitAfterTax..."
},
"subTotals": {
"totalOperatingCost": "...totalOperatingCost..."
},
// FOR XBRL FILING
"revenueBreakup": {
"revenueFromOperations": "...revenueFromOperations...",
"revenueFromInterest": "...revenueFromInterest...",
"revenueFromOtherFinancialServices": "...revenueFromOtherFinancialServices...",
"revenueFromSaleOfProducts": "...revenueFromSaleOfProducts...",
"revenueFromSaleOfServices": "...revenueFromSaleOfServices...",
"otherOperatingRevenues": "...otherOperatingRevenues...",
"exciseDuty": "...exciseDuty...",
"serviceTaxCollected": "...serviceTaxCollected...",
"otherDutiesTaxesCollected": "...otherDutiesTaxesCollected..."
}
// FOR E-FILING
"revenueBreakup": {
"saleOfGoodsManufacturedDomestic": "...saleOfGoodsManufacturedDomestic...",
"saleOfGoodsTradedDomestic": "...saleOfGoodsTradedDomestic...",
"saleOrSupplyOfServicesDomestic": "...saleOrSupplyOfServicesDomestic...",
"saleOfGoodsManufacturedExport": "...saleOfGoodsManufacturedExport...",
"saleOfGoodsTradedExport": "...saleOfGoodsTradedExport...",
"saleOrSupplyOfServicesExport": "...saleOrSupplyOfServicesExport..."
}
// FOR XBRL FILING
"depreciationBreakup": {
"depreciation": "...depreciation...",
"amortisation": "...amortisation...",
"depletion": "...depletion..."
}
// FOR E-FILING
"depreciationBreakup": {
"depreciationAndamortisation": "...depreciationAndamortisation..."
},
"metadata": {
"fileName": "...fileName...",
"fileURL": "...fileURL..."
}
},
"auditorComments": {
"reportHasAdverseRemarks": "...reportHasAdverseRemarks...",
"disclosuresAuditorReport": "...list of disclosuresAuditorReport...",
"disclosuresDirectorReport": "...list of disclosuresDirectorReport..."
}
}],
"financialParameters": [{
"year": "...year...",
"nature": "...nature...",
"earningFc": "...earningFc...",
"expenditureFc": "...expenditureFc...",
"employeeBenefitExpense": "...employeeBenefitExpense...",
"transactionRelatedPartiesAs18": "...transactionRelatedPartiesAs18...",
"grossFixedAssets": "...grossFixedAssets...",
"tradeReceivableExceedingSixMonths": "...tradeReceivableExceedingSixMonths...",
"proposedDividend": "...proposedDividend..."
}],
"industrySegments": [{
"industry": "...industry...",
"segments": "...list of segments..."
}],
"principalBusinessActivities": [{
"year": "...year...",
"mainActivityGroupCode": "...mainActivityGroupCode...",
"mainActivityGroupDescription": "...mainActivityGroupDescription...",
"businessActivityCode": "...businessActivityCode...",
"businessActivityDescription": "...businessActivityDescription...",
"percentageOfTurnover": "...percentageOfTurnover..."
}],
"shareholdings": [{
"shareholders": "...shareholders...",
"year": "...year...",
"category": "...category...",
"indianHeldNoOfShares": "...indianHeldNoOfShares...",
"indianHeldPercentageOfShares": "...indianHeldPercentageOfShares...",
"nriHeldNoOfShares": "...nriHeldNoOfShares...",
"nriHeldPercentageOfShares": "...nriHeldPercentageOfShares...",
"foreignHeldOtherThanNriNoOfShares": "...foreignHeldOtherThanNriNoOfShares...",
"foreignHeldOtherThanNriPercentageOfShares": "...foreignHeldOtherThanNriPercentageOfShares...",
"centralGovernmentHeldNoOfShares": "...centralGovernmentHeldNoOfShares...",
"centralGovernmentHeldPercentageOfShares": "...centralGovernmentHeldPercentageOfShares...",
"stateGovernmentHeldNoOfShares": "...stateGovernmentHeldNoOfShares...",
"stateGovernmentHeldPercentageOfShares": "...stateGovernmentHeldPercentageOfShares...",
"governmentCompanyHeldNoShares": "...governmentCompanyHeldNoShares...",
"governmentCompanyHeldPercentageOfShares": "...governmentCompanyHeldPercentageOfShares...",
"insuranceCompanyHeldNoOfShares": "...insuranceCompanyHeldNoOfShares...",
"insuranceCompanyHeldPercentageOfShares": "...insuranceCompanyHeldPercentageOfShares...",
"bankHeldNoOfShares": "...bankHeldNoOfShares...",
"bankHeldPercentageOfShares": "...bankHeldPercentageOfShares...",
"financialInstitutionsHeldNoOfShares": "...financialInstitutionsHeldNoOfShares...",
"financialInstitutionsHeldPercentageOfShares": "...financialInstitutionsHeldPercentageOfShares...",
"financialInstitutionsInvestorsHeldNoOfShares": "...financialInstitutionsInvestorsHeldNoOfShares...",
"financialInstitutionsInvestorsHeldPercentageOfShares": "...financialInstitutionsInvestorsHeldPercentageOfShares...",
"mutualFundsHeldNoOfShares": "...mutualFundsHeldNoOfShares...",
"mutualFundsHeldPercentageOfShares": "...mutualFundsHeldPercentageOfShares...",
"ventureCapitalHeldNoOfShares": "...ventureCapitalHeldNoOfShares...",
"ventureCapitalHeldPercentageOfShares": "...ventureCapitalHeldPercentageOfShares...",
"bodyCorporateHeldNoOfShares": "...bodyCorporateHeldNoOfShares...",
"bodyCorporateHeldPercentageOfShares": "...bodyCorporateHeldPercentageOfShares...",
"othersHeldNoOfShares": "...othersHeldNoOfShares...",
"othersHeldPercentageOfShares": "...othersHeldPercentageOfShares...",
"totalNoOfShares": "...totalNoOfShares...",
"totalPercentageOfShares": "...totalPercentageOfShares..."
}],
"shareholdingsSummary": [{
"year": "...year...",
"totalEquityShares": "...totalEquityShares...",
"totalPreferenceShares": "...totalPreferenceShares...",
"promoter": "...promoter...",
"public": "...public...",
"total": "...total..."
}],
"directorShareholdings": [{
"year": "...year...",
"dinPan": "...dinPan...",
"fullName": "...fullName...",
"designation": "...designation...",
"dateOfCessation": "...dateOfCessation...",
"noOfShares": "...noOfShares...",
"percentageHolding": "...percentageHolding..."
}],
"bifrHistory": "...list of bifrHistory...",
"cdrHistory": "...list of cdrHistory...",
"defaulterList": "...list of defaulterList...",
"legalHistory": "...list of legalHistory...",
"creditRatings": "...list of creditRatings...",
"holdingCompanies": "...list of holdingCompanies...",
"subsidiaryCompanies": "...list of subsidiaryCompanies..."
}
}
}