# Corporate Actions & Shareholder Governance

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

Product 5 in the [Partner API product catalog](/partners/docs/api-products), covering **13 operations**.

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

## Integration guides

[corporate governance api](/partners/docs/corporate-governance-api) · [complaints corporate actions insolvency](/partners/docs/complaints-corporate-actions-insolvency)

## Endpoint catalog

Paths are relative to `https://mystocks.africa/api/v1/partner` in production and `https://mystocks.africa/api/sandbox/v1/partner` in sandbox.

Open the [API Reference](/partners/docs/api-reference) and search the operation ID for request parameters, schemas, response codes, and examples. Use the [API Tester](/partners/docs/api-tester) to exercise an operation.

Sandbox availability is taken from each operation's OpenAPI metadata. Production-only operations and unsupported sandbox stubs are explicitly distinguished; account entitlements and instrument eligibility still apply.

| Method and path                                                | Operation ID                    | Purpose                                                       | Sandbox   |
| -------------------------------------------------------------- | ------------------------------- | ------------------------------------------------------------- | --------- |
| `GET /corporate-actions`                                       | `listCorporateActions`          | List corporate actions across symbols and exchanges           | Available |
| `GET /corporate-actions/{actionId}`                            | `getCorporateAction`            | Get authoritative corporate-action details                    | Available |
| `GET /dividends/{symbol}/history`                              | `getDividendHistory`            | Dividend history for a symbol                                 | Available |
| `GET /dividends/calendar`                                      | `listCalendar`                  | Dividend calendar                                             | Available |
| `GET /report/dividends`                                        | `getDividendReport`             | Report — Dividends                                            | Available |
| `GET /shareholder-meetings`                                    | `listShareholderMeetings`       | List AGM, EGM, court, and class meetings                      | Available |
| `GET /shareholder-meetings/{meetingId}`                        | `getShareholderMeeting`         | Get meeting, resolutions, proxy documents, and ballot choices | Available |
| `GET /users/{userId}/corporate-actions/{actionId}/elections`   | `getCorporateActionElection`    | Get election and custodian-acceptance status                  | Available |
| `POST /users/{userId}/corporate-actions/{actionId}/elections`  | `submitCorporateActionElection` | Submit or amend a corporate-action election                   | Available |
| `GET /users/{userId}/corporate-actions/{actionId}/entitlement` | `getCorporateActionEntitlement` | Get record-date corporate-action entitlement                  | Available |
| `GET /users/{userId}/shareholder-meetings/{meetingId}/ballot`  | `getShareholderBallot`          | Get record-date voting entitlement and ballot                 | Available |
| `GET /users/{userId}/shareholder-meetings/{meetingId}/votes`   | `getShareholderVote`            | Get vote and custodian-confirmation evidence                  | Available |
| `POST /users/{userId}/shareholder-meetings/{meetingId}/votes`  | `submitShareholderVote`         | Submit or amend resolution-level voting instructions          | Available |

## Shared contracts

[auth](/partners/docs/auth) · [errors](/partners/docs/errors) · [rate limits](/partners/docs/rate-limits) · [contract guarantees](/partners/docs/contract-guarantees)

[Download the September 2026 specification PDF](/docs/PartnerAPI.pdf). Read the [online clarifications](/partners/docs/partner-specification) before using the PDF's general examples.
