API
Stagingv2

Corporate

List corporate actions

Return corporate actions (dividends, rights, splits, schemes of arrangement and bonuses), filtered and paginated.

GET/v2/vendor/corporate-actions
Requires scopecorporate.actions

Query parameters

ParameterDescription
type
string
optional		Filter by action type.
One of dividend, rights, stock_split, scheme_of_arrangement, bonus.
security
string
optional		Filter by security code (upper-cased).
page
integer
optional		Page to fetch. Defaults to 1.
limit
integer
optional		Records per page, 1 to 100. Defaults to 20.

Response fields

FieldDescription
type
string
Corporate action type.
securityCode
string
Affected security.
dividendAmount
number
Dividend per share, when applicable.
qualificationDate
string
Qualification date.
paymentDate
string
Payment date.
documentUrl
string
Link to the supporting document.
Request
curl "https://stagingmobile.nasdng.com/v2/vendor/corporate-actions?type=dividend&page=1&limit=20" \
  -H "Authorization: Bearer sk_test_xxxxxxxxxxxxxxxxxxxxxxxx"
const params = new URLSearchParams({ type: "dividend", page: "1", limit: "20" });
const res = await fetch(
  `https://stagingmobile.nasdng.com/v2/vendor/corporate-actions?${params}`,
  { headers: { Authorization: "Bearer sk_test_xxxxxxxxxxxxxxxxxxxxxxxx" } }
);
const { data } = await res.json();
import requests

res = requests.get(
    "https://stagingmobile.nasdng.com/v2/vendor/corporate-actions",
    params={"type": "dividend", "page": "1", "limit": "20"},
    headers={"Authorization": "Bearer sk_test_xxxxxxxxxxxxxxxxxxxxxxxx"},
)
data = res.json()
Response 200 OK
{
  "success": true,
  "message": "Corporate actions fetched successfully",
  "data": {
    "data": [
      {
        "type": "dividend",
        "securityCode": "SDNASDPLC",
        "securityName": "NASD Plc",
        "ratio": null,
        "dividendAmount": 1.5,
        "paymentDate": "2026-05-30",
        "qualificationDate": "2026-05-16",
        "closureOfRegisterDate": "2026-05-17",
        "agmDate": "2026-05-28",
        "registrar": "Africa Prudential Plc",
        "year": 2026
      }
    ],
    "total": 34,
    "page": 1,
    "limit": 20
  }
}