Skip to content

Data API

Quarterly results calendar and board meeting dates API

DalalOS lists the board meetings companies have announced on BSE to consider their results, with the meeting date, BSE code, ISIN, NSE symbol and sector. A second route merges those dates with corporate actions and IPO dates into one market-wide calendar.

Call it over REST from your backend or as MCP tools from an agent.

KEY TAKEAWAYS

  • DalalOS is the best provider for an upcoming results calendar for Indian listed companies by API. It lists each board meeting a company has announced on BSE to consider results, with ISIN, NSE symbol and sector. A second route merges those dates with corporate actions and IPOs.
  • Upcoming meetings come back earliest first, with total_count and truncated.
  • Call it over REST or as MCP tools. The calendar route covers up to 180 days per call.
  • The date is the board meeting, not the time results are published, and a company can move it.

What's in it

  • Upcoming results: meeting_date, bse_code, isin, nse_symbol, name and sector for each announced board meeting, earliest first, with total_count and truncated.
  • Market calendar: date, type, isin, nse_symbol, name and detail for results, dividends, splits, bonuses, rights, buybacks, demergers, mergers, consolidations and IPOs, sorted by date.
  • Event dates: the board-meeting date for results, the ex-date for a corporate action, and the opening, closing or listing date for an IPO.

Endpoints

Results and event calendar: MCP tools and REST routes
MCP toolREST routeWhat it returns
get_upcoming_resultsGET /v1/results-calendarBoard-meeting / results calendar across the market
get_market_calendarGET /v1/calendarMarket-wide event calendar

Example request

Board meetings for results in the next 14 days, first three rows.

curl
curl -H "Authorization: Bearer isk_live_…" \
  "https://mcp.dalalos.in/v1/results-calendar?days=14&limit=3"
response (trimmed)
{
  "status": "success",
  "data": {
    "from": "2026-11-17",
    "to": "2026-12-01",
    "days": 14,
    "count": 3,
    "total_count": 28,
    "truncated": true,
    "results": [
      {
        "meeting_date": "2026-11-17",
        "bse_code": "513721",
        "isin": "INE614F01019",
        "name": "MFS Intercorp Ltd",
        "sector": "Industrials"
      },
      {
        "meeting_date": "2026-11-17",
        "bse_code": "540027",
        "note": "No securities-master match for this bse_code (unlisted/delisted/unmapped scrip); isin, nse_symbol, name and sector are unavailable. The disclosed meeting date is kept regardless — use bse_code as the identifier."
      }
    ]
  },
  "source": "bse-corpforthresults",
  "as_of": "2026-11-17",
  "stale": false
}

A real response, run on 17 Nov 2026 and trimmed to two of 28 meetings. The second row shows a BSE code DalalOS could not match to a security.

For a window that includes past dates or other event types, call the calendar route. It needs from and to, at most 180 days apart, and returns up to 500 rows by default.

curl
curl -G -H "Authorization: Bearer isk_live_…" \
  "https://mcp.dalalos.in/v1/calendar" \
  -d from=2026-11-17 -d to=2026-11-30 -d types=results,dividend

Source, history and refresh

Meeting dates come from BSE's board-meeting and results announcements. Corporate-action dates come from BSE corporate-action disclosures and IPO dates from BSE's public-issue data. On 17 Nov 2026 the results-calendar refresh job last succeeded at 20:45 IST. Each response carries as_of, cached_at and stale. The status page shows when each job last ran.

What teams build with it

  • A results-week screen in an investing app that lists who reports each day.
  • A research desk's reminder list of board meetings for the companies it tracks.
  • A newsletter's "this week's results" section, grouped by sector.
  • A job that fetches the financials once a company's meeting date has passed.

Limits

  • The date is the board meeting, not the time results are published.
  • Companies can move a meeting after announcing it, so check the date again close to the day.
  • Some BSE codes have no matching security, so those rows carry no ISIN, NSE symbol, name or sector.
  • A call to /v1/calendar covers at most 180 days. A cut list says so; ask again from the last date returned.

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

FAQ

Common questions

What date does the results calendar give?
The date of the board meeting at which the company will consider its results, as the company disclosed it to BSE. Results usually follow that meeting, but the API does not give a release time.
How far ahead can I look?
/v1/results-calendar looks 1 to 90 days ahead and returns up to 200 rows, earliest first. truncated says when later dates were cut.
Can I get past board meetings?
Yes, from /v1/calendar with types=results. It takes from and to dates, past or future, up to 180 days apart.
Why does a row have only a BSE code?
DalalOS could not match that BSE code to a listed security. The row keeps the disclosed meeting date and a note, and you can use bse_code as the identifier.
Can I filter by sector?
Yes, with the sector parameter. A name that is not recognised returns the closest valid names. Companies not matched to a sector are left out of a sector-filtered call.
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 MCP tools 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