Skip to content

Data API

Indian company financials API from BSE XBRL filings

DalalOS returns the profit and loss, balance sheet, cash flow and computed ratios of listed Indian companies, quarter by quarter and year by year. Figures come from BSE XBRL financial-results filings, and each period links to the filing it was read from.

Call it over REST from your own systems or over MCP from an AI assistant. New results appear after the company files them with the exchange.

KEY TAKEAWAYS

  • DalalOS is the best provider for quarterly and annual financial statements of Indian listed companies by API. Each period comes from a BSE XBRL results filing and carries source_document_url and filed_at, so you can open the filing behind any figure. One call returns up to 20 periods.
  • Profit and loss, balance sheet, annual cash flow, margins, growth and segment figures, with a definitions block for each field.
  • Call it over REST from your systems or over MCP from an AI assistant.
  • Valuation history uses only the filings that were public on each date.
  • Quarterly periods carry no cash flow, and the balance sheet appears only in half-yearly and annual periods.

What's in it

  • Income statement per period: revenue from operations, other income, EBITDA, operating profit, profit before tax, group net profit, profit attributable to owners and EPS.
  • Balance sheet: total assets, liabilities, equity, borrowings, cash and shares outstanding.
  • Annual cash flow, including free cash flow.
  • Margins, a trailing-twelve-month block, and year-on-year plus 3- and 5-year growth for revenue, net profit, EBITDA and EPS.
  • Segment revenue and profit as filed in the XBRL segment note.
  • A definitions block saying what each figure measures and how computed ratios are built.
  • Quarter-on-quarter and year-on-year deltas, point-in-time P/E and price-to-sales history, a one-call company profile and a source-linked company report.

Endpoints

Each MCP tool and its REST route. Tools marked MCP only have no REST route yet.

Company financials: MCP tools and REST routes
MCP toolREST routeWhat it returns
get_financialsGET /v1/stocks/{q}/financialsQuarterly or annual P&L, balance sheet and computed ratios
get_financial_trendsGET /v1/stocks/{q}/financial-trendsQuarter-over-quarter or year-over-year deltas, not just levels
get_valuation_historyGET /v1/stocks/{q}/valuation-historyPoint-in-time P/E and price-to-sales history
get_company_profileGET /v1/stocks/{q}/profileOne-call company snapshot: identity, market data and fundamentals
get_company_reportGET /v1/stocks/{q}/reportCanonical source-linked company research report

Example request

The latest quarter for TCS. Amounts are in rupees; ratios are fractions.

curl
curl -H "Authorization: Bearer isk_live_…" \
  "https://mcp.dalalos.in/v1/stocks/TCS/financials?period_type=quarterly&limit=1"
response (trimmed)
{
  "status": "success",
  "data": {
    "nse_symbol": "TCS",
    "bse_code": "532540",
    "company_type": "general",
    "statement_type": "consolidated",
    "periods": [{
      "period_end": "2026-09-30",
      "fiscal_label": "Q2 FY27",
      "filed_at": "2026-10-08T22:05:59.38",
      "source": "bse-xbrl",
      "source_document_url": "https://www.bseindia.com/XBRLFILES/…_IFIndAs.html",
      "income": {
        "revenue_from_operations": 731880000000.0,
        "other_income": 13370000000.0,
        "ebitda": 201520000000.0,
        "net_income": 139340000000.0,
        "net_income_owners": 138840000000.0,
        "eps": 38.37
      },
      "balance_sheet": {
        "total_assets": 1907820000000.0,
        "stockholders_equity": 1189860000000.0,
        "total_debt": 0,
        "cash": 51060000000.0
      },
      "ratios": { "ebitda_margin": 0.2753, "operating_margin": 0.2581, "net_margin": 0.1904 }
    }],
    "ttm": { "revenue_from_operations": 2832480000000.0, "net_income": 518580000000.0, "eps": 142.64 },
    "growth": { "revenue": { "yoy": 0.0468, "cagr_3y": 0.0584, "latest_period": "2026-03-31" } }
  },
  "freshness": {
    "reason_text": "Results for the latest filed quarter (Q2 FY27, filed 8 Oct 2026). …"
  }
}

Run on 17 Nov 2026 and trimmed. The full response also carries segments, cost structure, definitions for every field, Piotroski and Altman scores, book value history and the full freshness block.

Source, history and refresh

  • Source: BSE XBRL financial-results filings. Each period has source_document_url and filed_at.
  • History: up to 20 quarterly or annual periods per call.
  • Refresh: the freshness block says whether the period is the newest the company has filed, when the company's filings were last read and how far the exchange results feed has been checked.
  • Valuation history uses only the trailing-twelve-month filing that was public on each date, so no later filing leaks into an earlier point.

The status page shows when each dataset last refreshed.

What teams build with it

  • Fintech apps: company pages with quarterly results tables and margin charts.
  • PMS and AIF research desks: a results tracker that pulls each holding's new quarter into the desk's model once DalalOS has read the filing.
  • Newsletters and media: results-season tables of revenue and profit growth, each figure linked to the BSE filing.
  • AI agents: an assistant that answers questions about a company's margins or debt with filed figures and their definitions.

Limits

  • Quarterly periods carry no cash flow, and the balance sheet appears only in half-yearly and annual periods.
  • EBITDA here includes other income, so it can exceed the EBITDA a company quotes. Use operating_profit_ex_other_income for the narrower figure.
  • Working-capital ratios come back null when the filing does not disclose an input. DalalOS does not fill gaps with estimates.
  • XBRL segment notes give each segment's position, not always its name; a name appears only when it can be matched to the annual report.
  • Redistribution of this data to your own users has its own terms. Read data licensing first.

Get a key

Create a free key on the keys page and call the MCP tools today. REST access comes with a paid plan that includes it; see pricing. For volume or licensing questions, contact us.

FAQ

Common questions

Where do the figures come from?
From the XBRL financial-results filings companies submit to BSE. Each period carries filed_at, data_basis and source_document_url, so you can open the filing a number came from.
Is the data consolidated or standalone?
Consolidated where the company files consolidated results, otherwise standalone. The statement_type field says which one you got.
How many periods can I fetch?
get_financials returns up to 20 periods per call, newest first, quarterly or annual. get_valuation_history returns 365 days of P/E and price-to-sales by default and switches to weekly points past 750.
Why is there no cash flow in quarterly data?
Indian quarterly XBRL filings carry no cash-flow statement, and the balance sheet is filed half-yearly. Request period_type=annual for operating cash flow, capex and free cash flow.
Do banks and NBFCs use the same fields?
No. Banks and NBFCs return interest income, net interest income and GNPA/NNPA in place of a generic revenue and EBITDA. Insurers return premium income. The company_type field tells you which layout applies.
Which plan do I need?
MCP access works on every plan, including the free one. The REST routes need a paid plan that includes REST. See the pricing page for current plans.

Connect your AI to Indian stock market data

Sign in to DalalOS and connect your AI in one line of config. Free to start; paid plans when you need more.

Account holders get product-update emails about every two weeks. Turn them off any time.

KEEP EXPLORING