Skip to content
Stock Transfer In

Get Stock Transfer-In Request Details

Returns the details of a stock transfer-in request, including broker information, per-stock status (stocks[].state), the processing timeline, and supporting documents. Used on the transfer-in details page and to prefill the form when modifying the request. When can_modify is 1, the “Modify” and “Cancel” actions can be shown.

GEThttps://api.lbkrs.com/v2/portfolio/rollover/detail/{id}

Parameters

idstringpathRequired

Transfer-in request id

account_channelstringquery

Broker channel

Responses

HTTP 200The request succeeded. The response body contains the result of the “Get Stock Transfer-In Request Details” operation.
Standard response envelopecodemessagedata
dataobjectdata structure

Stock transfer-in record

idinteger

Transfer-in request id

aaidstring

aaid of the receiving account

marketstring

Transfer market

broker_idinteger

Delivering broker id; 0 means a manually entered broker

brokerstring

Delivering broker name

broker_enstring

Delivering broker name in English

codestring

Participant code of the delivering broker

accountstring

Account number of the Client at the delivering broker

namestring

Account holder name of the Client at the delivering broker

contactstring

Contact at the delivering broker

contact_emailstring

Email of the contact at the delivering broker

contact_phonestring

Phone number of the contact at the delivering broker

statestring

Status text for display

state_codeinteger

Request status code:

  • 0 - Submitted
  • 1 - Cancelled
  • 3 - Deposited
  • 5 - In progress
  • 7 - Partially deposited
  • 8 - Failed

Other values may appear; in that case rely on the state text.

can_modifyinteger

Whether the request can be modified or cancelled:

  • 1 - Yes; the modify and cancel endpoints can be called
  • 0 - No
app_statestring

Flag for whether the Client has notified the delivering broker; noticed means it has been marked as notified

attachmentsobject

Object storage keys of the supporting documents. Currently returned as a JSON-serialized string (such as ["<FILE_KEY_1>","<FILE_KEY_2>"]) that must be parsed first; a plain array is also possible

created_atinteger

Submission time, as a Unix timestamp in seconds

updated_atobject

Status update time, as a Unix timestamp in seconds; may be returned as a number or a string

process_atobject

Processing start time, as a Unix timestamp in seconds; may be returned as a number or a string

exec_atobject

Execution time, as a Unix timestamp in seconds; may be returned as a number or a string

reasonstring

Reason for cancellation, failure, or rejection

stocksarray<object>

Stocks to transfer in

Child attributes
counter_idstring

Security ID, such as ST/HK/700; may be missing, in which case identify the security by market and code

codestring

Stock code

namestring

Stock name

name_enstring

Stock name in English

marketstring

Market code, such as HK or US

currencystring

Settlement currency

amountnumber

Quantity to transfer in

costnumber

Cost price

stateinteger

Per-stock transfer status (returned by the details endpoint):

  • 0 - Processing
  • 1 - Succeeded
  • 2 - Failed
Whale Docs