Fetch By CIN Realtime

4 min

Introduction

This API allows you to fetch company consolidated data in real-time for a specific patron ID using a secure, authenticated POST request.

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	Type	Description
task	string	The task you want the endpoint to perform. In this case, the task is "fetchRealtime".
essentials	object	An object containing the essential parameters needed for the task to be performed. This includes the CIN (Corporate Identification Number) and callback URL.
cin	string	The Corporate Identification Number (CIN) of the company whose consolidated data you wish to fetch.
callbackUrl	string	The URL where the server will send the response when the task is completed. This is typically provided by the client.

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

Parameter Name	Data Type	Description
companyData	Object	An object containing various details of the company
authorizedCapital	String	The authorized capital of the company
cin	String	The Corporate Identification Number (CIN) of the company
efilingStatus	String	The e-filing status of the company
dateOfIncorporation	String	The date of incorporation of the company
legalName	String	The legal name of the company
companyName	String	The name of the company
paidUpCapital	String	The paid-up capital of the company
sumOfCharges	String	The sum of charges of the company
registeredAddress	Object	An object containing the registered address details of the company
city	String	The city of the registered address
pincode	String	The pincode of the registered address
state	String	The state of the registered address
businessAddress	Object	An object containing the business address details of the company
city	String	The city of the business address
pincode	String	The pincode of the business address
state	String	The state of the business address
pan	String	The Permanent Account Number (PAN) of the company
charges	String	A list of charges of the company
auditors	Array	An array of auditors of the company
detailedFinancials	Array	An array of detailed financials of the company
bs	Object	An object containing the balance sheet details of the company
assets	Object	An object containing the assets details of the company
liabilities	Object	An object containing the liabilities details of the company
subTotals	Object	An object containing the sub-totals of the balance sheet details of the company
metadata	Object	An object containing the metadata of the balance sheet details of the company
fileName	String	The file name of the balance sheet
fileURL	String	The URL of the balance sheet
pnl	Object	An object containing the profit and loss details of the company
lineItems	Object	An object containing the line items of the profit and loss details of the company
profitAfterTax	String	The profit after tax of the company
revenueBreakup	Object	An object containing the revenue breakup details of the company
depreciationBreakup	Object	An object containing the depreciation breakup details of the company
depreciation	String	The depreciation of the company
amortisation	String	The amortisation of the company
depletion	String	The depletion of the company
depreciationAndamortisation	String	The depreciation and amortisation of the company
auditorComments	Object	An object containing the auditor comments of the company
financialParameters	Array	An array of financial parameters of the company
industrySegments	Array	An array of industry segments of the company
principalBusinessActivities	Array	An array of principal business activities of the company
shareholdings	Array	An array of shareholdings of the company
shareholdingsSummary	Array	An array of shareholdings summary of the company
directorShareholdings	Array	An array of director shareholdings of the company