API product catalogCorporate Actions & Shareholder Governance

List corporate actions across symbols and exchanges

Corporate Actions & Shareholder Governance

GET

/corporate-actions

Sandbox availablelistCorporateActions

Returns authoritative mandatory and voluntary corporate actions. Filter by symbol, exchange, type, or lifecycle status.

Parameters

symbolstringquery

exchangestringquery

typestringquery

statusstringquery

limitintegerquery

Example: 100

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

actionsobject[]

actions[].idstringRequired

Example: "ca_abc123"

actions[].symbolstringRequired

Example: "SCOM.KE"

actions[].namestring | null

actions[].exchangestring | null

Example: "NSE"

actions[].typestringRequired

Example: "RIGHTS_ISSUE"

actions[].statusstringRequired

Example: "OPEN"

actions[].titlestringRequired

actions[].summarystring | null

actions[].termsstring | null

actions[].recordDatestring | null

actions[].electionDeadlinestring | null

actions[].effectiveDatestring | null

actions[].defaultOptionIdstring | null

actions[].optionsobject[]

actions[].documentsobject[]

actions[].authoritativeboolean

countinteger

Response codes

200Corporate-action registry.

Sandbox playground

Read-only sandbox request

symbol Optional · queryexchange Optional · querytype Optional · querystatus Optional · querylimit Optional · querySandbox API keyYour key stays in this page’s memory.

https://mystocks.africa/api/sandbox/v1/partner/corporate-actions

Open in API Tester API Reference

Response schema

{
  "type": "object",
  "properties": {
    "actions": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "symbol",
          "type",
          "title",
          "status"
        ],
        "properties": {
          "id": {
            "type": "string",
            "example": "ca_abc123"
          },
          "symbol": {
            "type": "string",
            "example": "SCOM.KE"
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "exchange": {
            "type": [
              "string",
              "null"
            ],
            "example": "NSE"
          },
          "type": {
            "type": "string",
            "example": "RIGHTS_ISSUE"
          },
          "status": {
            "type": "string",
            "example": "OPEN"
          },
          "title": {
            "type": "string"
          },
          "summary": {
            "type": [
              "string",
              "null"
            ]
          },
          "terms": {
            "type": [
              "string",
              "null"
            ]
          },
          "recordDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "electionDeadline": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "effectiveDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "defaultOptionId": {
            "type": [
              "string",
              "null"
            ]
          },
          "options": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "id",
                "label"
              ],
              "properties": {
                "id": {
                  "type": "string",
                  "example": "ACCEPT_ALL"
                },
                "label": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "requiresUnits": {
                  "type": "boolean",
                  "default": false
                },
                "allowPartial": {
                  "type": "boolean",
                  "default": false
                },
                "isDefault": {
                  "type": "boolean",
                  "default": false
                }
              }
            }
          },
          "documents": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "label": {
                  "type": "string"
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                }
              }
            }
          },
          "authoritative": {
            "type": "boolean"
          }
        }
      }
    },
    "count": {
      "type": "integer"
    }
  }
}

curl -X GET 'https://mystocks.africa/api/sandbox/v1/partner/corporate-actions' \
  -H "Authorization: Bearer $MYSTOCKS_SANDBOX_API_KEY"

Corporate Actions & Shareholder Governance

GET /corporate-actions/{actionId}