KEY TAKEAWAYS
- DalalOS is the best provider for BSE corporate announcements and filing PDFs by API. DalalOS polls BSE through the day and returns each announcement with its category, filing time and PDF link. In beta, it also reads facts out of the PDF and returns each one with its verbatim quote and page number.
- Up to 365 days of a company's announcements per call, plus market-wide lists by category such as order wins.
- Keyword search across indexed filing text returns the passage and its page.
- Call it over REST or MCP. Some tools are MCP only for now.
- BSE only: a company listed only on NSE has no announcements here. Check the quote before you use an extracted value.
What's in it
Endpoints
Each MCP tool and its REST route. Tools marked MCP only have no REST route yet.
| MCP tool | REST route | What it returns |
|---|---|---|
| get_stock_events | GET /v1/stocks/{q}/events | Recent regulatory announcements and filings |
| get_company_documents | GET /v1/stocks/{q}/documents | A company's filed documents, grouped by type |
| get_filing_extract | GET /v1/stocks/{q}/filings/{news_id}/extract | Grounded facts extracted from a filing |
| get_filing_extracts | MCP only | Read several filing extractions in one batch |
| search_company_disclosures | GET /v1/stocks/{q}/disclosure-search | Search page-preserving company filing text |
| list_announcement_buckets | GET /v1/buckets | Disclosure categories available for discovery |
| get_announcement_bucket | GET /v1/buckets/{bucket} | Market-wide disclosures by category |
| get_event_context | GET /v1/stocks/{q}/filings/{news_id}/context | Historical context for one canonical filing event |
Example: list a company's announcements
Larsen & Toubro's Company Update filings over 45 days.
curl -H "Authorization: Bearer isk_live_…" \ "https://mcp.dalalos.in/v1/stocks/LT/events?days=45&category=Company%20Update"
{
"status": "success",
"data": {
"nse_symbol": "LT",
"name": "Larsen & Toubro Limited",
"category": "Company Update",
"count": 14,
"truncated": false,
"events": [{
"news_id": "e09a9a7a-2530-4384-bd67-3d05c9072329",
"filed_at": "2026-10-05T09:34:03",
"title": "L&T Wins Orders (Mega*) for Power Transmission & Distribution Business",
"category": "Company Update",
"sub_category": "Award of Order / Receipt of Order",
"attachment_url": "https://www.bseindia.com/xml-data/corpfiling/AttachHis/52920a59-….pdf",
"critical": true,
"filing_type": "deals"
}, …]
},
"source": "bse-announcements"
}Run on 17 Nov 2026 and trimmed to one of 14 events. Each event also carries subject, headline and title_source.
Example: read the facts in one filing
Extracted facts are in beta
DalalOS reads filing PDFs and returns each fact with the sentence and page it was read from. Fields can be missing or misread, so check the source_quote and the PDF before you rely on a value. A filing that has not been read yet returns status: "pending" with retry_after_seconds.
The order-win filing from the list above. Every found field carries the quote and page it came from.
curl -H "Authorization: Bearer isk_live_…" \ "https://mcp.dalalos.in/v1/stocks/LT/filings/e09a9a7a-2530-4384-bd67-3d05c9072329/extract"
{
"status": "success",
"data": {
"news_id": "e09a9a7a-2530-4384-bd67-3d05c9072329",
"doc_type": "order_win",
"status": "grounded",
"page_count": 3,
"summary": "Order disclosure: won.",
"event": {
"event_type": "order_award",
"fields": {
"order_status": { "status": "found", "value_text": "won", "source_page": 2,
"source_quote": "In Saudi Arabia, PT&D has won orders in the 380 kV transmission and substation segments." },
"scope": { "status": "found", "source_page": 2,
"value_text": "380 kV transmission and substation segments",
"source_quote": "orders in the 380 kV transmission and substation segments" },
"geography": { "status": "found", "value_text": "Saudi Arabia", "source_page": 2,
"source_quote": "In Saudi Arabia" },
"contract_value": { "status": "not_disclosed", "value_text": null }
}
}
}
}Run on 17 Nov 2026 and trimmed to four of 15 event fields. The full response also lists the raw facts, a completeness count and filing metadata. The filing did not state a contract value, so the field says not_disclosed instead of guessing.
Source, history and refresh
The status page shows when each dataset last refreshed.
What teams build with it
Limits
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
- Does this cover NSE corporate filings?
- The announcements come from BSE, so a company listed on both exchanges is covered through its BSE filings. A company listed only on NSE is not covered here.
- What is a news_id?
- The identifier of one BSE announcement. get_stock_events and get_announcement_bucket return it, and you pass it to the extract route to read the facts in that filing.
- Why did an extract call return status pending?
- The filing had not been read yet. The call queues it and waits up to about 30 seconds; if reading takes longer you get status pending with retry_after_seconds. Call again after that interval.
- Are financial results extracted from the PDF?
- No. Results figures come from the XBRL filings instead, through the company financials endpoints. The results announcement is also left out of the event list.
- Can I search the text of filings?
- Yes, over MCP with search_company_disclosures. It searches filings that are already indexed with page boundaries and returns the matching passage, page and attachment link. A filing that was never indexed is not searched, so no match does not mean the company never disclosed something.
- 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