Skip to content
Shareholder Meetings

Submit Shareholder Meeting Instruction

Submits the attendance method and voting instructions for a shareholder meeting. attendee_info.attend_type determines what to submit:

  • 1 - Proxy voting: in voting_infos, submit one vote for each proposal in proxy_details
  • 2 - In-person attendance: in attendee_info, submit the name, gender, identification document, and address of the Client. The Broker App can prefill them from the Client's account opening information.
  • 3 - Proxy attendance: in attendee_info, submit the name, gender, identification document, and address of the proxy attendee

Prerequisite: before submission, show the meeting information, attendance method, and service fee (amount and currency from the list) to the Client and get confirmation. Success means only that the instruction was submitted. Track progress through apply_status of POST /corporate_action/history/voting/app. On failure, show message to the Client.

When calling through WhaleCore requestService(), set requiresTradeToken to true.

POSThttps://api.lbkrs.com/corporate_action/instruction/voting/app

Request body application/json

ann_idintegerrequired

Shareholder meeting ID from ann_id of the list, converted to a number

attendee_infoobjectrequired

Attendance method and attendee information. When attend_type is 2 (in-person attendance) or 3 (proxy attendance), also provide the attendee name, gender, document type, document number, and address. When it is 1 (proxy voting), only attend_type is needed.

Child attributes
attend_typeintegerrequired

Attendance method:

  • 0 - Unspecified
  • 1 - Proxy voting
  • 2 - In-person attendance
  • 3 - Proxy attendance

Only 1, 2, and 3 are valid when submitting an instruction.

Values
0
1
2
3
attendee_namestring

Attendee name in English. Only English letters, digits, and common punctuation are allowed.

attendee_genderinteger

Attendee gender:

  • 0 - Male
  • 1 - Female
Values
0
1
certificate_typestring

Attendee identification document type:

  • 0 - ID card
  • 1 - Passport
  • 2 - Driver's license
  • 3 - Business license
  • 4 - Business registration
  • 5 - Legal Entity Identifier (LEI)
  • 6 - Other business document
  • 10 - PR ID card
  • 11 - Citizen ID
  • 12 - Exit-Entry Permit for Travelling to and from Hong Kong and Macao
Values
0
1
2
3
4
5
6
10
11
12
attendee_identification_numberstring

Attendee document number. Only English letters, digits, and common punctuation are allowed.

attendee_addressstring

Attendee address in English. Only English letters, digits, and common punctuation are allowed.

voting_infosarray<object>

Votes for each proposal. Required when attend_type is 1.

Child attributes
chosen_proxy_serialstringrequired

Proposal number from proxy_details[].proxy_serial

voteintegerrequired

Voting option:

  • 1 - Approve
  • 2 - Reject
  • 3 - Abstain
Values
1
2
3

Responses

HTTP 200The request succeeded. The response body contains the result of the “Submit Shareholder Meeting Instruction” operation.
Standard response envelopecodemessagedata
dataobjectdata structure

Always null. Use code to determine whether the request succeeded.

No nested fields

Whale Docs