Corp Action Management

Corporate Action - Get In-Progress Flow Ticket Info

Gets the in-progress flow-ticket information of a given corporate action.

Request parameters

Required: ann_id (corporate action ID), flow_ticket_type (flow ticket type)
When querying the flow ticket for executing or revoking a corporate action, pass 1 (announcement); for tax refund or refund revocation, pass 2 (refund).

Response

On success, the flow-ticket ID is returned in data.flow_ticket_id, which the caller can use to open the corresponding flow-ticket page.

POSThttps://b-api.lbkrs.com/corporate_action/flow_ticket/info

Production: https://b-api.lbkrs.com · Test: https://b-api.longbridge.xyz

Authorization

AuthorizationstringheaderRequired

Send the Broker ACCESS_TOKEN as Authorization: Bearer <token>.

Permission

lb_hk_corporate.corporate_query

The Broker ACCESS_TOKEN must be granted the permission below, or the call will be rejected.

Request body application/json

ann_idstringrequired

Corporate action ID identifying the corporate action whose flow ticket is queried.

flow_ticket_typeintegerrequired

Flow ticket type.

0 · Unspecified1 · Announcement2 · Refund

Responses

HTTP 200The request was processed successfully. The flow-ticket information is returned in data.flow_ticket_id.

Standard response envelopecodemessagedata

dataobjectdata structure

flow_ticket_idnumberrequired

Returned value: ID in the flow-ticket system; use it to open the corresponding flow-ticket page.

HTTP 400Bad request. Check the business error code in code and the error details in message.

Standard response envelopecodemessagedata

dataobjectdata structure

No nested fields

HTTP 401The user is not authenticated, or the login session has expired.

Standard response envelopecodemessagedata

dataobjectdata structure

No nested fields

HTTP 403The current account is not authorized to use this feature. Grant the required permission to the account in User Permission.

Standard response envelopecodemessagedata

dataobjectdata structure

No nested fields

HTTP 408The request timed out. Check the business error code in code and the error details in message.

Standard response envelopecodemessagedata

dataobjectdata structure

No nested fields

Request

curl --request POST \
  --url 'https://b-api.lbkrs.com/corporate_action/flow_ticket/info' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json'
  --data '{
  "ann_id": "117456",
  "flow_ticket_type": 1
}'

Response

{
  "code": 0,
  "message": "success",
  "data": {
    "flow_ticket_id": 88012345
  }
}