Get dividends, splits, bonus issues, rights and board meetings for an Indian listed company by name

View all Indian Stock Exchange API endpoints →

Returns the corporate-action record of one Indian listed company, looked up by company name through the required stock_name query parameter (for example infosys). The response is a JSON object with five sections: board_meetings, dividends, splits, bonus and rights. In the observed probe call for stock_name=infosys (HTTP 200), every section carried a title and a msg string. Sections with history also carried a header array of column names and a data array of rows: board_meetings used the columns Date and Agenda, dividends used Record Date, Ex-Date, Dividend Percentage and Details, and bonus used Record Date, Ex-Date and Ratio. Sections with nothing to report (splits and rights in the probe) omitted header and data and returned only a plain-language msg, such as a note that no stock split has been announced for the last few years. In the sampled rows every cell was a string and dates were formatted DD-MM-YYYY. No formal response schema is published, so the section layout above is observed behaviour from one probe rather than a guaranteed contract. The data is informational and is not a substitute for the official exchange filing.

API Features

Five action types in one response A single call returns the board_meetings, dividends, splits, bonus and rights sections together, so you do not need a separate request per event type.
Lookup by plain company name The only input is stock_name, such as infosys. You do not need an exchange ticker or a BSE scrip code to retrieve the corporate-action record.
Row tables with named columns Sections that have history include a header array and a data array of rows. In the probe, dividends listed Record Date, Ex-Date, Dividend Percentage and Details, so columns can be mapped by header instead of guessed positions.
Readable empty-state messages When a company has no split or rights history, the section still returns a title and a msg sentence instead of an error, so an empty section is a normal result you can display directly.
Dividend dates and payout detail Each dividend row pairs the record date and ex-date with a dividend percentage string and a free-text Details line describing the declaration, including interim or final dividend wording.

Live API Demo

GET /api/project/indian-stock-exchange-api/corporate-actions

Request cost is temporarily unavailable. No price is assumed.

View pricing

API Response (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/indian-stock-exchange-api/corporate-actions?key=<API_KEY>&stock_name=infosys'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

Frequently asked questions

What does the Corporate Actions endpoint return?

It returns a JSON object with five sections for the requested company: board_meetings, dividends, splits, bonus and rights. Each section has a title and a msg, and sections with history add a header array of column names plus a data array of rows. This layout was observed in a probe call for infosys.

Which parameter do I need to send?

Only stock_name, which is required. Pass the company name, for example infosys. You do not need an NSE or BSE ticker or a scrip code. The probe used stock_name=infosys and returned HTTP 200.

Why do splits or rights come back without a data table?

In the probe, splits and rights contained only a title and a msg saying the company had not announced a split or rights issue for the last few years. Treat a missing header and data as "no events", and check for those keys before reading rows.

What columns do the dividend, bonus and board meeting rows use?

In the probe, board_meetings rows had Date and Agenda, dividends rows had Record Date, Ex-Date, Dividend Percentage and Details, and bonus rows had Record Date, Ex-Date and Ratio (for example 1:1). Dates were strings in DD-MM-YYYY format and the dividend percentage was a string such as 520%.

How many rows can I expect, and is there pagination?

No pagination or row-limit parameter is documented. For infosys the probe returned 100 board meeting rows, 50 dividend rows and 4 bonus rows, but counts depend on the company and on how much history is available, so do not hard-code them.

Is the response shape guaranteed?

No formal response schema is published for this endpoint. The section names and columns come from one observed probe, so parse defensively, tolerate missing header or data keys, and keep the raw row text when a field is unfamiliar.

Can I use this data to place trades or as an official record?

No. The values are informational market snapshots. For regulatory or accounting purposes, confirm dividends, splits and bonus issues against the company announcement on the exchange before acting on them.

Related operations

Guides

View Subscription Plans →