# 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.
