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
Endpoints
| MCP tool | REST route | What it returns |
|---|---|---|
| get_upcoming_results | GET /v1/results-calendar | Board-meeting / results calendar across the market |
| get_market_calendar | GET /v1/calendar | Market-wide event calendar |
Example request
Board meetings for results in the next 14 days, first three rows.
curl -H "Authorization: Bearer isk_live_…" \ "https://mcp.dalalos.in/v1/results-calendar?days=14&limit=3"
{
"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 -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
Limits
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