API product catalogCorporate Actions & Shareholder Governance

Submit or amend resolution-level voting instructions

Corporate Actions & Shareholder Governance

POST

/users/{userId}/shareholder-meetings/{meetingId}/votes

Sandbox availablesubmitShareholderVote

Parameters

userIdstringpathRequired

meetingIdstringpathRequired

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Idempotency-KeystringheaderRequired

Unique string that makes write calls safe to retry on network failure. Required for money movement, trading, KYC, subscriptions, and webhook creation. Deduplicated for 24 hours -- duplicate keys return the cached response. HTTP 409 if a concurrent request with the same key is still in progress.

Example: dep_user42_1743152580

Request body

ballotsobject[]Required

ballots[].resolutionIdstringRequired

ballots[].choicestringRequired

Example: "FOR"

acknowledgementstringRequired

Response fields

messagestring

voteobject

vote.statusPENDING_CUSTODIAN | ACCEPTED | REJECTED

vote.revisioninteger

vote.submittedAtstring | null

vote.amendedAtstring | null

vote.custodianReferencestring | null

vote.custodianReasonstring | null

vote.acceptedAtstring | null

vote.confirmationDocumentUrlstring | null

Response codes

200Vote revision queued for custodian acceptance

Request reference

Sandbox available

userId Required · pathmeetingId Required · path

Use the API Tester for write requests, including request bodies and idempotency keys.

https://mystocks.africa/api/sandbox/v1/partner/users/%7BuserId%7D/shareholder-meetings/%7BmeetingId%7D/votes

Open in API Tester API Reference

Response schema

{
  "type": "object",
  "properties": {
    "message": {
      "type": "string"
    },
    "vote": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "enum": [
            "PENDING_CUSTODIAN",
            "ACCEPTED",
            "REJECTED"
          ]
        },
        "revision": {
          "type": "integer",
          "minimum": 1
        },
        "submittedAt": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "amendedAt": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "custodianReference": {
          "type": [
            "string",
            "null"
          ]
        },
        "custodianReason": {
          "type": [
            "string",
            "null"
          ]
        },
        "acceptedAt": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "confirmationDocumentUrl": {
          "type": [
            "string",
            "null"
          ],
          "format": "uri"
        }
      }
    }
  }
}

curl -X POST 'https://mystocks.africa/api/sandbox/v1/partner/users/%7BuserId%7D/shareholder-meetings/%7BmeetingId%7D/votes' \
  -H "Authorization: Bearer $MYSTOCKS_SANDBOX_API_KEY" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "ballots": [{ "resolutionId": "RESOLUTION_1", "choice": "FOR" }],
  "acknowledgement": "Customer reviewed the proxy materials and confirmed these choices."
}'

GET /users/{userId}/shareholder-meetings/{meetingId}/votes

Institutional Reporting, Auditing & Compliance