Skip to content
Shareholder Meetings

List Shareholder Meeting Applications

Lists, page by page, shareholder meeting instructions submitted by the current account, together with voting details. Used for the shareholder meeting history page and application details page. When search.filters.ann_id is provided, only records of that meeting are returned.

When voting_details is not empty, show the attendance method as proxy voting (1); in this case attendee_info.attend_type might not be a valid value. When apply_status is 2, the Client can cancel through POST /corporate_action/cancel/voting/app. Pagination: page starts from 1. When the returned list has fewer items than size, there is no more data.

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

Request body application/json

searchobjectrequired
Child attributes
filtersobjectrequired
Child attributes
marketstringrequired

Market code. The Broker App uses HK.

ann_idstring

Shareholder meeting ID. When provided, only this meeting is queried.

pageintegerrequired

Page number, starting from 1

sizeintegerrequired

Records per page. The Broker App uses 10.

Responses

HTTP 200The request succeeded. The response body contains the result of the “List Shareholder Meeting Applications” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
historyarray<object>

Instruction record list

Child attributes
ann_idstring

Shareholder meeting ID

stock_codestring

Security code

stock_namestring

Security name

meeting_typestring

Display text for the meeting type, such as Annual General Meeting

meeting_timestring

Meeting time in YYYYMMDD HH:mm format, interpreted in UTC+8

meeting_placestring

Meeting address

record_datestring

Record date

polling_numberstring

Number of votes available, in shares

amountstring

Service fee for submitting the instruction. See currency for the currency.

currencystring

Currency of the service fee

voting_start_dateinteger

Application start time, as a Unix timestamp in seconds

voting_deadlineinteger

Application deadline, as a Unix timestamp in seconds. If no instruction is submitted before the deadline, the Client is considered to have waived the meeting.

apply_statusinteger

Shareholder meeting instruction status:

  • 1 - To apply
  • 2 - Pending
  • 3 - Completed
  • 4 - Cancelled
  • 5 - Processing

Only instructions in status 2 can be cancelled.

Values
1
2
3
4
5
proxy_timeinteger

Instruction submission time, as a Unix timestamp in seconds

attendee_infoobject

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_detailsarray<object>

Voting details for each proposal. A non-empty array means the attendance method is proxy voting.

Child attributes
proxy_serialstring

Proposal number

resolution_descriptionstring

Proposal content

voting_instructioninteger

Voting option:

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

Total number of matching records

Whale Docs