1. Corporate Actions
  • 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
      • GetCorporateAnnouncements
    • Corporate Announcement Attachment Downloader
      • GetCorporateAnnouncementAttachment
    • Corporate Actions
      • GetCorporateActionsCategories
        GET
      • GetCorporateActions
        GET
    • 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 Actions

GetCorporateActions

GET
https://test.lisuns.com:4532/GetCorporateActions
▶️ 'Try It' now ! Actual data is returned as on 27th February 2025
pointer.gif
GetCorporateActions returns company-initiated events that impact shareholders, such as dividends, stock splits, mergers, acquisitions, and buybacks. They affect stock price, market cap, and investor sentiment, making them key for financial analysis and investment decisions.
The optional parameters like 'actionType' and 'purposeCode' can be fetched using the GetCorporateActionsCategories functions

What is returned?#

ScripId, ScripCode, ScripName, ActionId, IndustryName, ListedStatus, ScripFaceValue, ISIN, AnnounceType, AnnouncementDate, MeetingDate, CorporateActionType, PurposeCode, AnnouncementUrl, RatioAmount, BcRdFlag, BcRdFrom, BcRdTo, ProvXdate, NdStartDate, NdEndDate, PaymentDate, ReferenceSrno, ModifyDate, ReceivedAt, SavedAt
For details, please see glossary

Sample Response#

JSON
XML
CSV
CsvContent
{
"Value":[
{ "ScripId": "SHRINIWAS",
"ScripCode": 538897,
"ScripName": "Shri Niwas Leasing and Finance Limited",
"ActionId": 0,
"IndustryName": "Financial Services",
"ListedStatus": "Active",
"ScripFaceValue": "10.0",
"ISIN": "INE201F01015",
"AnnounceType": "U",
"AnnouncementDate": "02-20-2025 16:36:03",
"MeetingDate": ""01-01-0001 00:00:00"",
"CorporateActionType": "Right Issue of Equity Shares",
"PurposeCode": "ET ",
"AnnouncementUrl": "https://www.bseindia.com/xml-data/corpfiling/AttachHis/3f6bbaa7-8faa-4e87-8aa8-824213bfa789.pdf",
"RatioAmount": "00100001 ",
"BcRdFlag": "RD",
"BcRdFrom": ""02-27-2025 00:00:00"",
"BcRdTo": ""02-27-2025 00:00:00"",
"ProvXdate": ""02-27-2025 00:00:00"",
"NdStartDate": ""01-01-0001 00:00:00"",
"NdEndDate": ""01-01-0001 00:00:00"",
"PaymentDate": ""01-01-0001 00:00:00"",
"ReferenceSrno": "1",
"ModifyDate": "02-24-2025 16:43:15",
"ReceivedAt": "02-24-2025 16:44:02",
"SavedAt": "02-24-2025 16:44:02"}
]}

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/GetCorporateActions?accessKey=30bd31ff-fb7e-4d6c-a76e-06750e3eeb09&exchange=BSE&instrumentIdentifier=KSB&from=1740594600&to=1740594600&actionType=Dividend&purposeCode=DP&dTFormat=String&format=Json'

Responses

🟢200OK
text/plain
Success
Body

Example
{
    "value": [
        {
            "symbol": "string",
            "scripCode": 0,
            "actionId": 0,
            "companyName": "string",
            "industryName": "string",
            "listedStatus": "string",
            "scripFaceValue": 0,
            "isin": "string",
            "announceType": "string",
            "announcementDate": "02-25-2025 18:00:00",
            "meetingDate": "02-25-2025 18:00:00",
            "corporateActionType": "string",
            "purposeCode": "string",
            "announcementUrl": "string",
            "ratioAmount": "string",
            "bcRdFlag": "string",
            "bcRdFrom": "02-25-2025 18:00:00",
            "bcRdTo": "02-25-2025 18:00:00",
            "provXdate": "02-25-2025 18:00:00",
            "ndStartDate": "02-25-2025 18:00:00",
            "ndEndDate": "02-25-2025 18:00:00",
            "paymentDate": "02-25-2025 18:00:00",
            "referenceSrno": 0,
            "modifyDate": "02-25-2025 18:00:00",
            "receivedAt": "02-25-2025 18:00:00",
            "savedAt": "02-25-2025 18:00:00"
        }
    ],
    "count": 0
}
Modified at 2025-09-23 08:27:08
Previous
GetCorporateActionsCategories
Next
GetResultsCalendar
Built with