Corporate Actions
Fetches corporate actions for a company (dividends, bonus issues, stock splits, and rights issues), including announcement dates, ex-dates, record dates, amounts, and ratios.
Rate Limits
| Plan | Rate Limit |
|---|---|
| Hobby | 5 requests / day |
| Plus | 10 requests / minute |
Request
GET /api/corporate-actions/{company_symbol}
| Parameter | Description | Priority | Type |
|---|---|---|---|
| api_key | User Generated API Key. Generate Here | required | string |
| force_update | Bypass cache and refresh from the data provider Default false | optional | boolean |
Response
| Field | Description | Type |
|---|---|---|
| success | Indicates if the API call was successful or not | string |
| company | Name of the company | string |
| trading_symbol | NSE / BSE trading symbol | string |
| isin | ISIN used to resolve corporate actions | string |
| data | List of corporate action events | array |
| data.name | Event type, e.g. Dividend, Bonus, Split, Rights | string |
| data.expiry_date | Ex-date or effective date of the action | string |
| data.amount | Monetary amount (typically dividends); may be null | decimal |
| data.ratio | Ratio for bonus / split / rights (e.g. 1:1); null if N/A | string |
| data.event_details | Detailed key-value pairs for the event | array |
| data.event_details.name | Label, e.g. Announcement date, Ex dividend date | string |
| data.event_details.value | Value for that label | string |
Example
curl -X GET \ -H "Content-Type: application/json" \ --url 'https://api.fincrux.org/api/corporate-actions/RELIANCE?api_key={api_key}'
{ "success": "true", "company": "Reliance Industries Limited", "trading_symbol": "RELIANCE", "isin": "INE002A01018", "data": [ { "name": "Dividend", "expiry_date": "14 Aug 2025", "amount": 5.5, "ratio": null, "event_details": [ { "name": "Announcement date", "value": "25 Apr 2025" }, { "name": "Ex dividend date", "value": "14 Aug 2025" }, { "name": "Record date", "value": "14 Aug 2025" }, { "name": "Dividend type", "value": "Final" }, { "name": "Amount", "value": "5.5" }, { "name": "Dividend %", "value": "55.0" }, { "name": "Details", "value": "Rs.5.5000 per share(55%)Final Dividend" } ] } ] }