Data API's

company info

Fetch key company information for a single equity instrument, including company overview, valuation and profitability ratios, industry benchmarks, shareholding pattern, and key price and financial indicators.

post/data/companyinfo

Headers

access-tokenstring required

Request body

securityIdstring required

Exchange standard ID for each security
For eg. "1333"

exchangeSegment'NSE_EQ' | 'BSE_EQ' required

Enums	Exchange	Segment
NSE_EQ	NSE	Equity Cash
BSE_EQ	BSE	Equity Cash

instrument'EQUITY' required

Enums	Description
EQUITY	Equity

metricsstring[] required

Example request

{
  "metrics": [
    "CO"
  ]
}

Response

Successful operation

securityIdstring

Echoed from request

dataobject

Single-element array containing the isin and requested section blocks.

Response Parameters — CO (Company Overview)

Parameters	Data Type	Description	Sample value
MARKET_CAP	String	Market capitalisation in Rs Cr.	36318.4
INDUSTRY	String	Specific industry in which the company operates.	Cement
SECTOR	String	Broad economic sector to which the company belongs.	Construction
DIVIDEND_YIELD	String	Annual dividend per share as a percentage of the current market price.	0.21
EPS	String	Earnings attributable to each outstanding equity share, based on the trailing twelve months.	60.7
EBITDA	String	Earnings before interest, tax, depreciation, and amortisation for the trailing twelve months, in ₹ crore.	3278
BOOK_VALUE	String	Latest book value per equity share, in ₹.	958.52
FIFTY_TWO_WEEK_HIGH	String	Highest price at which the security traded during the previous 52 weeks.	1245
FIFTY_TWO_WEEK_LOW	String	Lowest price at which the security traded during the previous 52 weeks.	865.5

Response Parameters — RATIOS (Return Ratios)

Parameters	Data Type	Description	Sample value
PE_RATIO	String	Price-to-Earnings ratio of the company based on trailing twelve-month earnings.	31.2
PB_RATIO	String	Price-to-Book ratio of the company.	2.01
DEBT_TO_EQUITY	String	Ratio of the company's total debt to shareholders' equity.	0.65
PE_TO_SECTOR_PE	String	Ratio of the company's PE ratio to the average PE ratio of its sector.	0.82
ROE	String	Return on Equity, indicating how efficiently the company generates profit using shareholders' equity, expressed as a percentage.	3.99
ROCE	String	Return on Capital Employed, indicating how efficiently the company generates operating profit using the capital employed, expressed as a percentage.	4.86
INDUSTRY_EPS	String	Average earnings per share of companies operating in the same industry.	42.6
INDUSTRY_DEBT_TO_EQUITY	String	Average debt-to-equity ratio of companies operating in the same industry.	0.85
INDUSTRY_PB_RATIO	String	Average price-to-book ratio of companies operating in the same industry.	4.2
INDUSTRY_CURRENT_RATIO	String	Average current ratio of companies operating in the same industry.	1.75
INDUSTRY_DIVIDEND_YIELD	String	Average dividend yield of companies operating in the same industry, expressed as a percentage.	1.4
INDUSTRY_OPERATING_MARGIN	String	Average operating profit margin of companies operating in the same industry, expressed as a percentage.	18.6

Response Parameters — SHP (Shareholding Pattern)

Parameters	Data Type	Description	Sample value
REPORTING_PERIOD	String	Latest quarter for which shareholding data is reported, in YYYYMM format.	202603
PROMOTER_HOLDING	String	Percentage of the company's total shares held by promoters and the promoter group.	55.84
DII_HOLDING	String	Percentage of the company's total shares held by domestic institutional investors.	20.25
CHANGE_IN_DII_HOLDING	String	Change in DII holding compared with the previous reported quarter, in percentage points.	1.26
FII_HOLDING	String	Percentage of the company's total shares held by foreign institutional investors.	7.15
CHANGE_IN_FII_HOLDING	String	Change in FII holding compared with the previous reported quarter, in percentage points.	-0.77
PUBLIC_HOLDING	String	Percentage of the company's total shares held by public or retail shareholders.	8.06

Example response

{
  "securityId": "1333",
  "data": {
    "CO": {
      "MARKET_CAP": 36318.4,
      "INDUSTRY": "Refineries",
      "SECTOR": "Energy",
      "DIVIDEND_YIELD": 0.35,
      "EPS": 42.5,
      "EBITDA": 1611.8,
      "BOOK_VALUE": 512.3,
      "FIFTY_TWO_WEEK_HIGH": 1611.8,
      "FIFTY_TWO_WEEK_LOW": 1249.8
    },
    "RATIOS": {
      "PE_RATIO": 5.54,
      "PB_RATIO": 0.7271,
      "DEBT_TO_EQUITY": 0,
      "PE_TO_SECTOR_PE": 0.5426,
      "ROE": 12.4,
      "ROCE": 14.8,
      "INDUSTRY_EPS": 38.1,
      "INDUSTRY_DEBT_TO_EQUITY": 0.42,
      "INDUSTRY_PB_RATIO": 1.1,
      "INDUSTRY_CURRENT_RATIO": 1.6,
      "INDUSTRY_DIVIDEND_YIELD": 0.9,
      "INDUSTRY_OPERATING_MARGIN": 18.2
    },
    "SHP": {
      "REPORTING_PERIOD": "30-06-2026",
      "PROMOTER_HOLDING": 50.35,
      "DII_HOLDING": 15.2,
      "CHANGE_IN_DII_HOLDING": 0.4,
      "FII_HOLDING": 22.1,
      "CHANGE_IN_FII_HOLDING": -0.3,
      "PUBLIC_HOLDING": 12.35
    }
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.