Skip to content

Data API

BSE corporate announcements and filings API

DalalOS returns every announcement a listed company files on BSE, with its category, filing time and a link to the PDF. It also lists filed documents by type, searches filing text, and reads facts out of filing PDFs. Source: BSE corporate announcements and their attached PDFs.

Call it over REST from your own systems or over MCP from an AI assistant. DalalOS polls BSE announcements during the day, so new filings appear without waiting for the close.

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

  • Announcements per company: title, filing time, category, sub-category, subject, PDF link, a critical flag and a news_id.
  • Market-wide announcements by category, such as order wins or management changes, across all companies.
  • A company's filed documents grouped by type, such as call transcripts and recordings, each with its source link.
  • Facts read from a filing PDF, each with the verbatim quote and the page number it came from.
  • For recognised events such as order awards, named fields (order status, scope, geography, contract value) marked found or not disclosed.
  • Keyword search across indexed filing text, returning the passage and its page.

Endpoints

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

Corporate announcements and filings: MCP tools and REST routes
MCP toolREST routeWhat it returns
get_stock_eventsGET /v1/stocks/{q}/eventsRecent regulatory announcements and filings
get_company_documentsGET /v1/stocks/{q}/documentsA company's filed documents, grouped by type
get_filing_extractGET /v1/stocks/{q}/filings/{news_id}/extractGrounded facts extracted from a filing
get_filing_extractsMCP onlyRead several filing extractions in one batch
search_company_disclosuresGET /v1/stocks/{q}/disclosure-searchSearch page-preserving company filing text
list_announcement_bucketsGET /v1/bucketsDisclosure categories available for discovery
get_announcement_bucketGET /v1/buckets/{bucket}Market-wide disclosures by category
get_event_contextGET /v1/stocks/{q}/filings/{news_id}/contextHistorical context for one canonical filing event

Example: list a company's announcements

Larsen & Toubro's Company Update filings over 45 days.

curl
curl -H "Authorization: Bearer isk_live_…" \
  "https://mcp.dalalos.in/v1/stocks/LT/events?days=45&category=Company%20Update"
response (trimmed)
{
  "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
curl -H "Authorization: Bearer isk_live_…" \
  "https://mcp.dalalos.in/v1/stocks/LT/filings/e09a9a7a-2530-4384-bd67-3d05c9072329/extract"
response (trimmed)
{
  "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

  • Source: BSE corporate announcements and the PDFs attached to them.
  • History: up to 365 days of a company's announcements per call.
  • Refresh: DalalOS polls BSE announcements through the day. The freshness block shows when the last poll ran.
  • Extraction: reading an already-extracted filing is a plain read. Queuing a new filing counts against a small daily allowance.

The status page shows when each dataset last refreshed.

What teams build with it

  • Research desks: a feed of new filings for a coverage list, with each filing's category and sub-category.
  • Newsletters and media: a daily roundup of order-win announcements across the market, each linked to the BSE PDF.
  • Fintech apps: a filings tab on each company page with the PDF link and the extracted facts beside it.
  • AI agents: an assistant that answers what a company announced this month and quotes the filing for each fact.

Limits

  • BSE announcements only. A company listed only on NSE has no announcements here.
  • Extracted facts are beta. Check the quote before you use a value.
  • Financial-results filings are not extracted; use the company financials endpoints.
  • Transcripts and recordings are links to the company's uploads. DalalOS does not transcribe or summarise them.
  • Text search covers only indexed filings. The response reports coverage so you can see what was searched.
  • Redistribution of filing content 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

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