API product catalogCorporate Actions & Shareholder Governance

List AGM, EGM, court, and class meetings

Corporate Actions & Shareholder Governance

GET

/shareholder-meetings

Sandbox availablelistShareholderMeetings

Parameters

symbolstringquery

exchangestringquery

statusstringquery

limitintegerquery

Example: 100

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

meetingsobject[]

meetings[].idstringRequired

Example: "mtg_abc123"

meetings[].symbolstringRequired

Example: "SCOM.KE"

meetings[].namestring | null

meetings[].exchangestring | null

Example: "NSE"

meetings[].meetingTypeAGM | EGM | COURT | CLASS | OTHERRequired

meetings[].statusOPEN | CLOSED | CONFIRMED | CANCELLEDRequired

meetings[].titlestringRequired

meetings[].descriptionstring | null

meetings[].meetingDatestringRequired

meetings[].recordDatestringRequired

meetings[].votingDeadlinestringRequired

meetings[].defaultTreatmentstring

meetings[].documentsobject[]

meetings[].resolutionsobject[]

countinteger

Response codes

200Shareholder meeting registry

Sandbox playground

Read-only sandbox request

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

https://mystocks.africa/api/sandbox/v1/partner/shareholder-meetings

Open in API Tester API Reference

Response schema

{
  "type": "object",
  "properties": {
    "meetings": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "symbol",
          "meetingType",
          "status",
          "title",
          "meetingDate",
          "recordDate",
          "votingDeadline"
        ],
        "properties": {
          "id": {
            "type": "string",
            "example": "mtg_abc123"
          },
          "symbol": {
            "type": "string",
            "example": "SCOM.KE"
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "exchange": {
            "type": [
              "string",
              "null"
            ],
            "example": "NSE"
          },
          "meetingType": {
            "type": "string",
            "enum": [
              "AGM",
              "EGM",
              "COURT",
              "CLASS",
              "OTHER"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "OPEN",
              "CLOSED",
              "CONFIRMED",
              "CANCELLED"
            ]
          },
          "title": {
            "type": "string"
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "meetingDate": {
            "type": "string",
            "format": "date-time"
          },
          "recordDate": {
            "type": "string",
            "format": "date"
          },
          "votingDeadline": {
            "type": "string",
            "format": "date-time"
          },
          "defaultTreatment": {
            "type": "string"
          },
          "documents": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "label": {
                  "type": "string"
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                },
                "type": {
                  "type": "string",
                  "example": "PROXY_FORM"
                }
              }
            }
          },
          "resolutions": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "id",
                "title",
                "choices"
              ],
              "properties": {
                "id": {
                  "type": "string"
                },
                "number": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "title": {
                  "type": "string"
                },
                "description": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "managementRecommendation": {
                  "type": "string",
                  "enum": [
                    "FOR",
                    "AGAINST",
                    "NONE"
                  ]
                },
                "choices": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          }
        }
      }
    },
    "count": {
      "type": "integer"
    }
  }
}

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

GET /report/dividends

GET /shareholder-meetings/{meetingId}