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

GetCorporateActionsCategories

GET
https://test.lisuns.com:4532/GetCorporateActionsCategories
▶️ 'Try It' now ! Actual data is returned as on 27th February 2025
pointer.gif
GetCorporateActionsCategories function retrieves a list of corporate action categories available for a specific exchange.

What is returned?#

CorporateActiontype, PurposeCode
For details, please see glossary

Sample Response#

JSON
XML
CSV
CsvContent
{
"Value":[
{ "CorporateActiontype": "A.G.M.",
"PurposeCode": "AGM"},
{ "CorporateActiontype": "Amalgamation",
"PurposeCode": "AM "},
{ "CorporateActiontype": "Annual Book Closure",
"PurposeCode": "ABC"},
{ "CorporateActiontype": "Bonus issue",
"PurposeCode": "BN "},
{ "CorporateActiontype": "Buy Back of Shares",
"PurposeCode": "BGM"},
{ "CorporateActiontype": "Change in Terms or Status",
"PurposeCode": "EX "},
{ "CorporateActiontype": "Consolidation of Shares",
"PurposeCode": "CS "},
{ "CorporateActiontype": "Conversion of FCD",
"PurposeCode": "FC "}}

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/GetCorporateActionsCategories?accessKey=30bd31ff-fb7e-4d6c-a76e-06750e3eeb09&exchange=BSE&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
GetCorporateAnnouncementAttachment
Next
GetCorporateActions
Built with