SubscribeCorporateAnnouncements returns official company disclosures on earnings, mergers, dividends, leadership changes, and other key events that impact shareholders, stock prices, and investment decisions.
The optional parameters like 'descriptor','descriptorId' and 'category' can be fetched using the GetCorporateAnnouncementsCategories REST API functions.
Supported Parameters
| Parameter |
ValueType |
Description |
| Exchange |
String value like BSE |
Name of supported exchange. Use the GetExchanges function to retrieve the list of available exchanges.
|
| Descriptor |
String value |
Optional Parameter. Name or description of the corporate announcement category. Example: Board Meeting, Dividend, Results, etc.
|
| DescriptorId |
Integer value |
Optional Parameter. Unique identifier assigned to a specific announcement descriptor/category.
|
| Category |
String value |
Optional Parameter. Classification of the corporate announcement used to group similar announcement types.
|
| Unsubscribe |
[true] / [false], default = [false] |
Optional parameter. By default subscribes to the selected category updates. If set to
true, the corresponding subscription is removed.
|
What is returned?
ScripId, FillingDate, MeetingDate, TradeDate, ScripCode, ScripName, FileStatus, HeadLine, NewsSubject, AttachmentName, NewsBody, Descriptor, CriticalNews, AnnounceType, MeetingType, DescriptorId, AttachmentUrl, ReceivedAt, SavedAt
For details, please see glossary.
Sample Code Snippet ( JavaScript)
function SubscribeCorporateAnnouncements()
{
var request1 =
{
"MessageType": "SubscribeCorporateAnnouncements",
"Exchange": "BSE"
//"Descriptor": "TestDescriptor",
//"DescriptorId": "",
//"Category": "",
//"Unsubscribe": false
}
doSend(request1);
}
Sample Response
Time : Mon May 25 2026 15:37:49 GMT+0530 (India Standard Time)
RESPONSE: {"Exchange":"BSE",
"ScripId":"CMMHOSP",
"FillingDate":1779703656,
"MeetingDate":1779647400,
"TradeDate":1779703656,
"ScripCode":523489,
"ScripName":"Chennai Meenakshi Multispeciality Hospital Ltd-$",
"FileStatus":"N",
"HeadLine":"Board Meeting Outcome for The Approved Audited Financial Results Along With Audit Report, Cash Flow Statement For The Year Ended 31St March, 2026 And Declaration On The Report Of Auditors With Unmodified Opinion In The 25Th May 2026 Board Meeting.",
"NewsSubject":"Board Meeting Outcome for The Approved Audited Financial Results Along With Audit Report, Cash Flow Statement For The Year Ended 31St March, 2026 And Declaration On The Report Of Auditors With Unmodified Opinion In The 25Th May 2026 Board Meeting.",
"AttachmentName":"bcb3c595-d00a-4408-ada6-524540b50379.pdf",
"NewsBody":"This is to intimate that the Board of Directors of the Company at its meeting held on Monday, May 25, 2026 at the registered office of the Company have inter alia approved the Audited Financial Results for the quarter and financial year ended 31st March, 2026. The Board of Directors have not recommended any Dividend for the year 2025-26.The approved Audited Financial Results along with audit report, Cash Flow Statement for the year ended 31st March, 2026 and declaration on the report of auditors with unmodified opinion are enclosed with this letter.Further, we would like to inform that the financial results will be published in the newspapers pursuant to Regulation 47 of the SEBI (Listing Obligations and Disclosure Requirements) Regulations, 2015. The financial results are also available on the Company's website - www.cmmh.in.The meeting commenced at 12:00 Hours and concluded at 15:00 Hours.",
"Descriptor":"Revision of outcome",
"CriticalNews":0,
"AnnounceType":"Outcome",
"MeetingType":"",
"DescriptorId":"208",
"Category":"Outcome of Board Meeting",
"AttachmentUrl":"https://www.bseindia.com/stockinfo/annpdfopen.aspx?pname=bcb3c595-d00a-4408-ada6-524540b50379.pdf","ReceivedAt":1779703668,"SavedAt":0,"MessageType":"RealtimeCorporateAnnouncement"}