Skip to main content

Shareholders

Upload up to 50 shareholder records per request, scoped to one eventId. Each record carries holdings, contact info, and voting preference.

Tips​

  • Either email or address is required on every record. The request fails validation if both are missing.
  • preferredVoting is required. Omit it and the whole batch rejects.
  • naaPreference is required when preferredVoting is Full Set. When preferredVoting is E-Delivery it is optional.
  • Submit each account number once per CUSIP per event. Do not include the same account and CUSIP twice in a request, and do not resubmit an account that was already accepted. Duplicates are not rejected and not merged: either record may be the one that is kept, so the stored data becomes inconsistent.
  • One account, two CUSIPs of the same issuer: send two records. If a shareholder holds more than one security of the issuer, send one record per CUSIP with the same accountNo and a different cusipNo. When you later request the voting URL, pass cusipNo to Voting so VOTR knows which holding the ballot is for.
  • noboObo defaults to obo if you don't send it. Send it explicitly if you can — it controls how issuers communicate with the holder.
  • CUSIP is exactly 9 uppercase alphanumerics. The validator is strict.
  • Hard deadline. After the shareholder reporting deadline you'll get 403. Submit on the evening of the record date.
Loading playground…