API product catalogCorporate Actions & Shareholder Governance

Get vote and custodian-confirmation evidence

Corporate Actions & Shareholder Governance

GET

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

Sandbox availablegetShareholderVote

Parameters

userIdstringpathRequired

meetingIdstringpathRequired

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

eligibleboolean

entitlementobject | null

voteunion

Response codes

200Vote status and confirmation

Sandbox playground

Read-only sandbox request

userId Required · pathmeetingId Required · pathSandbox API keyYour key stays in this page’s memory.

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": {
    "eligible": {
      "type": "boolean"
    },
    "entitlement": {
      "type": [
        "object",
        "null"
      ]
    },
    "vote": {
      "anyOf": [
        {
          "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"
            }
          }
        },
        {
          "type": "null"
        }
      ]
    }
  }
}

curl -X GET 'https://mystocks.africa/api/sandbox/v1/partner/users/%7BuserId%7D/shareholder-meetings/%7BmeetingId%7D/votes' \
  -H "Authorization: Bearer $MYSTOCKS_SANDBOX_API_KEY"

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

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