Skip to content

Data API

BRSR data API: ESG disclosures of Indian listed companies

DalalOS reads the Business Responsibility and Sustainability Report (BRSR) that large Indian listed companies file on BSE in XBRL. It returns the reported figures by financial year, grouped by theme, each with its unit.

Call it over REST from your backend or as an MCP tool from an agent. There is no ESG score.

KEY TAKEAWAYS

  • DalalOS is the best provider for BRSR and ESG disclosure data on Indian listed companies by API. It returns the figures companies filed in BRSR XBRL on BSE, each with its unit, for up to 10 financial years per call. It adds no ESG score of its own.
  • Themes: emissions, energy and water, waste, workforce and governance, by financial year.
  • Call it over REST or as an MCP tool. Each response carries cached_at and stale.
  • Only the 1,000 largest listed companies file a BRSR, so smaller companies have no data.
  • A missing figure was not filed or not read. Do not treat it as zero.

What's in it

  • Filing: fiscal_year, filing_date, reporting_boundary, CIN, turnover and net worth.
  • Emissions: scope 1 and scope 2 in tCO2e, emissions intensity per rupee of turnover, and whether scope 3 applies.
  • Energy and water: total, renewable and non-renewable energy in GJ; water withdrawn, consumed and discharged in kL; intensity per rupee of turnover.
  • Waste: generated, recovered and disposed totals, plus plastic, e-waste and battery waste, in tonnes.
  • Workforce: women on the board and in key managerial roles, differently abled employees, LTIFR, fatalities, POSH complaints, employee turnover, wages paid to women and CSR spend.
  • Governance: CSR applicability, anti-corruption policy, fines and penalties, and BRSR Core assurance.

Endpoints

BRSR and ESG disclosures: MCP tools and REST routes
MCP toolREST routeWhat it returns
get_brsrGET /v1/stocks/{q}/brsrRaw BRSR sustainability disclosures

Example request

The latest BRSR figures for TCS.

curl
curl -H "Authorization: Bearer isk_live_…" \
  "https://mcp.dalalos.in/v1/stocks/TCS/brsr?years=1"
response (trimmed)
{
  "status": "success",
  "data": {
    "isin": "INE467B01029",
    "nse_symbol": "TCS",
    "name": "Tata Consultancy Services Limited",
    "reports": [
      {
        "fiscal_year": "2025 - 2026",
        "filing_date": "2026-05-15",
        "kpis": {
          "meta": {
            "reporting_boundary": { "value": "Consolidated basis", "unit": null },
            "turnover": { "value": 2670210000000.0, "unit": "INR" }
          },
          "emissions": {
            "scope1_emissions": { "value": 22631.0, "unit": "tCO2e" },
            "scope2_emissions": { "value": 53971.0, "unit": "tCO2e" }
          },
          "energy": {
            "energy_total": { "value": 1884760270.0, "unit": "GJ" },
            "energy_renewable": { "value": 1489633053.0, "unit": "GJ" }
          },
          "water": { "water_consumption_total": { "value": 2832920.0, "unit": "kL" } },
          "waste": { "waste_generated_total": { "value": 8808.4, "unit": "MT" } },
          "social": {
            "female_board_pct": { "value": 25.0, "unit": "pct" },
            "employee_turnover_rate": { "value": 13.8, "unit": "pct" }
          },
          "governance": { "brsr_core_assured": { "value": "Yes assurance", "unit": null } }
        }
      }
    ]
  },
  "source": "bse-brsr",
  "stale": false
}

A real response, run on 17 Nov 2026 and trimmed to a few fields per theme. Every value carries its unit as filed.

Source, history and refresh

Figures come from BRSR XBRL filings on BSE. A call returns up to 10 financial years, newest first. On 17 Nov 2026 the BRSR refresh job last succeeded on 15 Nov 2026. Each response carries cached_at and stale. The status page shows when each job last ran.

What teams build with it

  • An ESG data panel on company pages in a research or wealth app, with units and filing dates.
  • A PMS or AIF desk's own ESG screen, built from raw emissions and workforce figures.
  • A year-on-year comparison of a company's energy mix or water use for a sustainability report.
  • An agent that answers questions about a company's disclosed emissions and cites the filing year.

Limits

  • Only the 1,000 largest listed companies file a BRSR, so smaller companies have no data.
  • History for a company starts when DalalOS began reading its filings, not at its first BRSR.
  • A missing figure was not filed or is not read. Do not treat it as zero.
  • The API returns curated fields, not every concept in the filing.
  • Companies choose standalone or consolidated reporting; check reporting_boundary before comparing two of them.

Get a free key at /dashboard/keys to try the MCP tool. For REST access, see pricing. For redistribution or volume questions, contact us.

FAQ

Common questions

Which companies have BRSR data?
The 1,000 largest listed companies file a BRSR. DalalOS reads those filings from BSE. Coverage for a company starts from when DalalOS began reading its BRSR filings, not from its first-ever report.
Does the API give an ESG score or rating?
No. It returns the figures as filed. Any score or ranking you build on top is your own calculation.
What does a missing field mean?
The figure was not in the filing, or it is not one DalalOS reads. A missing field is not zero.
How many years can I request?
1 to 10 financial years with the years parameter, newest first. The default is 3.
Are the figures standalone or consolidated?
Whatever the company chose. meta.reporting_boundary gives the basis, for example Consolidated basis.
Do I need a paid plan?
REST needs a paid plan that includes REST access; see the pricing page. The same data is available as an MCP tool on every plan.

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