1. Corporate Announcements
  • Fundamental Data API - Introduction
  • Authentication, Request & Response
  • Code Samples & API Trial
  • List of APIs
  • Type of Corporate Data Available
  • Corporate Data APIs
    • Corporate Announcements
      • GetCorporateAnnouncementsCategories
        GET
      • GetCorporateAnnouncements
        GET
    • Corporate Announcement Attachment Downloader
      • GetCorporateAnnouncementAttachment
    • Corporate Actions
      • GetCorporateActionsCategories
      • GetCorporateActions
    • Financial Results
      • GetResultsCalendar
      • GetFinancialResultsItems
      • GetFinancialResults
      • GetFinRatioEOD
      • GetFinRatioQuarterly
      • GetFinRatioSnapshot
    • Sectoral Classification
      • GetSectoralClassification
      • GetSectors
      • GetMei
      • GetIndustries
      • GetBasicIndustries
    • Share Holding Patterns
      • GetShpItems
      • GetSHP
      • GetSHPAdvanced
    • Market Capitalization
      • GetScripMCap
      • GetExchangeMCap
    • Voting Results
      • GetVotingItems
      • GetVoting
    • Corporate Governance
      • GetCorporateGovernanceItems
      • GetCorporateGovernance
    • Annual Results (PDF)
      • GetAnnualReports
    • Company Information
      • GetCompanyData
    • Bulk / Block Deals
      • GetBulkDeals
      • GetBlockDeals
    • Delivery Volumes
      • GetDeliveryVolumes
    • Promoter's Pledge
      • GetConsolidatedPledge
  • Other Data APIs
    • Index Constituents
    • GetEODStats
      GET
    • GetBhavCopyCM
      GET
    • GetBhavCopyFO
      GET
    • GetFuturesAndOptions
      GET
    • GetIndexDetail
      GET
    • GetCircuitFilterDetails
      GET
    • GetStatisticsGroupAbCompanies
      GET
    • GetTop5GainersLosers
      GET
    • GetIndexHighlights
      GET
    • GetTotalTradeHighlights
      GET
    • GetScripGroupTradeHighlights
      GET
    • GetTurnoverDetailsOfTop15ScripsofAgroup
      GET
  • EOD Statistics
    • GetSeriesChange
    • GetBannedSecurities
    • ​GetDeliverable
    • GetVolatality
    • GetNewHL
    • GetCircuitBreakers
  • Helper APIs
    • GetServerInfo
    • GetLimitation
    • GetInstruments
  • Glossary
    • Glossary
  • Diagnostic API Responses
    • Diagnostic API Responses
  • Release Notes
    • 📢Release Notes
  1. Corporate Announcements

GetCorporateAnnouncements

GET
https://test.lisuns.com:4532/GetCorporateAnnouncements
▶️ 'Try It' now ! Actual data is returned as on 27th February 2025
pointer.gif
GetCorporateAnnouncements 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 functions.

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 the complete glossary.

Sample Response#

JSON
XML
CSV
CsvContent
{
"Value":[
{ "ScripId": "KARURVYSYA",
"FillingDate": "02-27-2025",
"MeetingDate": "01-01-0001",
"TradeDate": "02-27-2025",
"ScripCode": 590003,
"ScripName": "KARUR VYSYA BANK LTD.",
"FileStatus": "N",
"HeadLine": "Karur Vysya Bank inaugurates 6 new branches today",
"NewsSubject": "Karur Vysya Bank inaugurates 6 new branches today",
"AttachmentName": "25D02536-41FA-47C9-83E9-53DBE2225779-175624.pdf",
"NewsBody": "Karur Vysya Bank Ltd has submitted to BSE a copy of Press Release dated February 27, 2025 titled 'Karur Vysya Bank inaugurates 6 new branches today'.",
"Descriptor": "General",
"CriticalNews": 0,
"AnnounceType": "General",
"MeetingType": "",
"DescriptorId": "1",
"AttachmentUrl": "https://www.bseindia.com/stockinfo/AnnPdfOpen.aspx?Pname=25D02536-41FA-47C9-83E9-53DBE2225779-175624.pdf",
"ReceivedAt": "02-27-2025 17:57:03",
"SavedAt": "02-27-2025 17:57:03"}
]}

Request

Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://test.lisuns.com:4532/GetCorporateAnnouncements?accessKey=30bd31ff-fb7e-4d6c-a76e-06750e3eeb09&exchange=BSE&instrumentIdentifier=GODREJPROP&from=1740594600&to=1740680999&descriptor=Press Release / Media Release&descriptorId=35&category=Announcement under Regulation 30 (LODR)&hasMeeting=&dTFormat=String&format=Json'

Responses

🟢200OK
text/plain
Success
Body

Example
{
    "value": [
        {
            "symbol": "string",
            "fillingDate": "02-25-2025",
            "meetingDate": "02-25-2025",
            "tradeDate": "02-25-2025",
            "scripCode": 0,
            "companyName": "string",
            "fileStatus": "string",
            "headLine": "string",
            "newsSubject": "string",
            "attachmentName": "string",
            "newsBody": "string",
            "descriptor": "string",
            "criticalNews": 0,
            "announceType": "string",
            "meetingType": "string",
            "descriptorId": "string",
            "attachmentUrl": "string",
            "receivedAt": "02-25-2025 18:00:00",
            "savedAt": "02-25-2025 18:00:00"
        }
    ],
    "count": 0
}
Modified at 2025-09-23 08:32:27
Previous
GetCorporateAnnouncementsCategories
Next
GetCorporateAnnouncementAttachment
Built with