Skip to content
Account Profile & Status

Retrieve Account Application Information

Returns the account-opening application data for a securities account.

Request parameters

  • This endpoint has no required parameters; see the field definitions for optional parameters.
  • See the field definitions for each field's format, allowed values, and business meaning.

Business notes

Returns the complete opening data: application ID, client type, account type, account status, customer name, contacts (phone and email lists), plus identity-document, basic, occupation, financial, compliance, risk, identity-verification, and signature information.

Returns

On success, returns the account-opening application data. See the response definition for field meanings.

GEThttps://b-api.lbkrs.com/v1/whaleapi/account/open_info

Authorization

AuthorizationstringheaderRequired

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

Permission

kyc.hk_account

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

Parameters

account_nostringRequired

Account Number

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 200Successful response
Standard response envelopecodemessagedata
dataobjectdata structure
application_idstringrequired

Account opening application ID. Account opening application ID

client_typestringrequired

Account Open subject type. Account Open subject type

broker_codestringrequired

Broker account. Broker account

account_typestringrequired

Account type. Account type

account_stateobjectrequired

Account state. Account state

client_namestringrequired

Client Name. Client Name

contactobjectrequired

Contact list. Contact list

Child attributes
phonesarray<object>required

Phone list. Phone list

Child attributes
country_codestringrequired

Phone Country Code. Phone Country Code

mobilestringrequired

Phone Number. Phone Number

contact_typeintegerrequired

contact_type

emailsarray<object>required

Email list. Email list

Child attributes
emailstringrequired

Email. Email

open_infoobjectrequired

open_info

Child attributes
baseobjectrequired

base

Child attributes
passport_namestringrequired

Name of master card (Pinyin). Name of master card (Pinyin)

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

Whale Docs