Get quarterly results, yearly results, balance sheet, cash flow, ratios and shareholding history for an Indian stock by company name

View all Indian Stock Exchange API endpoints →

Returns historical financial statistics for one Indian listed company, looked up by company name. stock_name is required (for example TCS, or TATAMOTORS as in the endpoint documentation). stats is optional and names the statistic groups to return; its documented default is the comma-separated list quarter_results, yoy_results, balancesheet, cashflow, ratios, shareholding_pattern_quarterly and shareholding_pattern_yearly, while the documentation's example request uses a single value, quarter_results. No probe call was made for this endpoint, so every response detail below comes from an unverified source example: a JSON object keyed by line item (Sales, Expenses, Operating Profit, OPM %, Other Income, Interest, Depreciation, Profit before tax, Tax %, Net Profit and EPS in Rs), where each item maps period labels such as Jun 2021, Sep 2021 and Mar 2024 to numbers. That example holds 13 quarterly periods per line item and resembles the quarter_results group; the labels appear in alphabetical rather than chronological order, and no currency units are stated beyond the EPS in Rs and percentage labels. The response layouts of the other six groups, how several groups are combined in one response and the behavior for an unknown company name are not verified. The figures are informational and not audited filings or investment advice.

API Features

Seven statistic groups on one parameter The stats parameter names the groups to return: quarter_results, yoy_results, balancesheet, cashflow, ratios, shareholding_pattern_quarterly and shareholding_pattern_yearly. The documented default lists all seven.
Quarterly results by line item The source example is an object keyed by line item such as Sales, Expenses, Operating Profit, Net Profit and EPS in Rs, each holding values for 13 quarters, ready to pivot into a table.
Margin and tax percentages included The example carries OPM % and Tax % rows beside the absolute figures, so margin and tax-rate trends can be charted without recomputing them from Sales and Profit before tax.
Quarterly and yearly shareholding groups Two shareholding_pattern groups, one quarterly and one yearly, are among the documented stats values for tracking ownership change over time. Their response layout has not been verified.
Period labels as object keys Each line item maps labels like Jun 2024 or Mar 2023 to a number. The example lists labels alphabetically, so parse them into dates and sort on your side before plotting.
Company name, not scrip code stock_name takes a plain name such as TCS or TATAMOTORS, so a results lookup does not need a BSE scrip code or an exchange-specific identifier first.

Live API Demo

GET /api/project/indian-stock-exchange-api/historical-stats

Request cost is temporarily unavailable. No price is assumed.

View pricing

API Response (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/indian-stock-exchange-api/historical-stats?key=<API_KEY>&stats=quarter_results%2Cyoy_results%2Cbalancesheet%2Ccashflow%2Cratios%2Cshareholding_pattern_quarterly%2Cshareholding_pattern_yearly&stock_name=TCS'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

Frequently asked questions

What does the Historical Stats endpoint return?

A JSON object of financial statistics for the requested company. In the supplied source example (not a probe) each key is a line item such as Sales, Expenses, Operating Profit, OPM %, Net Profit or EPS in Rs, and each value maps period labels like Jun 2021 to a number. That example shows 13 quarters and resembles the quarter_results group.

What does the stats parameter accept?

A comma-separated list of group names: quarter_results, yoy_results, balancesheet, cashflow, ratios, shareholding_pattern_quarterly and shareholding_pattern_yearly. The documented default requests all seven, and the documentation's example request passes only quarter_results.

Is stats required or optional?

The written endpoint notes call stats required, but the declared parameter is optional with a default of all seven groups. stock_name is the only parameter that is always required. Sending stats explicitly keeps the response predictable.

Has this endpoint been tested with a live call?

No probe call was made for Historical Stats. The response description comes from a source example, so the layouts of yoy_results, balancesheet, cashflow, ratios and the shareholding groups, and the shape of a multi-group response, are unverified.

In what order do the period columns come back?

In the source example the period labels appear alphabetically (Dec 2021, Dec 2022, Dec 2023, Jun 2021 and so on), not chronologically. Parse each label into a date and sort in your own code before charting or comparing quarters.

Which units do the figures use?

The example does not state units except for the EPS in Rs label and the OPM % and Tax % percentage rows. Check the monetary scale against the company's own filings before using the numbers in a model.

Do I need an NSE ticker or BSE scrip code?

stock_name is described as a company name, and the examples use TCS and TATAMOTORS. How the lookup treats partial or misspelled names is unverified, so resolve ambiguous names first with the Industry Search endpoint, which returns NSE and BSE codes.

Related operations

Guides

View Subscription Plans →