Get Corporate Actions

API to retrieve the corporate actions for a company identified by its ISIN. The response contains a list of events such as dividends, bonus issues, stock splits, and rights issues, each with detailed sub-event information including announcement dates, ex-dates, record dates, and amounts.

Path Parameters

Name	Required	Type	Description
isin	true	string	International Securities Identification Number (ISIN) of the company. Example: INE002A01018.

Request

curl --location 'https://api.upstox.com/v2/fundamentals/INE002A01018/corporate-actions' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {your_access_token}'

For additional samples in various languages, please refer to the Sample code section on this page.

Responses

• 200
• 4XX

---

Response Body

{
  "status": "success",
  "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" }
      ]
    }
  ]
}

Name	Type	Description
status	string	A string indicating the outcome of the request. Possible values: success, error.
data	array	List of corporate action events.
data[].name	string	Type of corporate action, e.g., Dividend, Bonus, Split, Rights.
data[].expiry_date	string	Ex-date or effective date of the corporate action.
data[].amount	number	Monetary amount associated with the action (applicable for dividends).
data[].ratio	string	Ratio applicable for bonus or split actions (e.g., 1:1). null if not applicable.
data[].event_details	array	Detailed key-value pairs with full event information.
data[].event_details[].name	string	Label describing the event detail, e.g., Announcement date, Ex dividend date.
data[].event_details[].value	string	Corresponding value for the event detail.

Error codes

Error code	Description
UDAPI1206	Invalid ISIN - The provided ISIN is invalid.

Sample Code

Python

import requests

url = 'https://api.upstox.com/v2/fundamentals/INE002A01018/corporate-actions'
headers = {
    'Accept': 'application/json',
    'Authorization': 'Bearer {your_access_token}'
}

response = requests.get(url, headers=headers)
print(response.json())

Node.js

const axios = require('axios');

axios.get('https://api.upstox.com/v2/fundamentals/INE002A01018/corporate-actions', {
  headers: {
    'Accept': 'application/json',
    'Authorization': 'Bearer {your_access_token}'
  }
}).then(response => console.log(response.data))
  .catch(error => console.error('Error:', error));

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class GetCorporateActions {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder()
                .uri(new URI("https://api.upstox.com/v2/fundamentals/INE002A01018/corporate-actions"))
                .header("Accept", "application/json")
                .header("Authorization", "Bearer {your_access_token}")
                .GET()
                .build();
        HttpClient client = HttpClient.newHttpClient();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

PHP

<?php
$url = 'https://api.upstox.com/v2/fundamentals/INE002A01018/corporate-actions';
$headers = [
    'Accept: application/json',
    'Authorization: Bearer {your_access_token}'
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_errno($ch) ? print('Error: ' . curl_error($ch)) : print($response);
curl_close($ch);
?>

Loading...