Get Controlling Persons

Look up the controlling persons associated with an account.

Request parameters

Required: account_no (the account number to look up)
See each field's documentation for format, value ranges, and business meaning.

Returns

On success, data carries the controlling-person information for the account; see the response definition for field meanings.

POSThttps://b-api.lbkrs.com/crs/get_controlling_persons

Authorization

AuthorizationstringheaderRequired

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

Permission

report.crs_data

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

Request body application/json

account_nostringrequired

Account number whose controlling persons are queried. This field is required.

account_no is the securities account number (such as L6VQEU00121996). It differs from the customer ID member_id and the internal securities account ID aaid.

Responses

HTTP 200The request was processed successfully. data carries the controlling-person information for the account.

Standard response envelopecodemessagedata

dataobjectdata structure

listarray<object>

Controlling person list. May be an empty array.

Child attributes

idstring

account_nostring

res_country_codestring

country_codestring

tinstring

first_namestring

last_namestring

addressstring

birthdaystring

typestring

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/crs/get_controlling_persons' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json'
  --data '{
  "account_no": ""
}'

Response

{
  "code": 0,
  "message": "success",
  "data": {
    "list": []
  }
}