API product catalog

Corporate Actions & Shareholder Governance

MyStocks Partner API

Corporate actions, entitlements, elections, shareholder meetings, proxy votes, and dividend data.

Integration guides Get a sandbox key

Explore endpoints

13 of 13

GET

/corporate-actions

List corporate actions across symbols and exchanges

Full endpoint documentation

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"

Was this page useful?

Your signal helps us tighten partner onboarding docs.

Send note

Last updated on

POST /topup

GET /corporate-actions