Skip to content
Risk Assessment and Investor Certification

Get Risk Assessment and Professional Investor Status

Returns the Client current risk assessment level and Professional Investor (PI) certification status. The Broker App calls it before opening the risk assessment page or the PI certification page. If risk has a value, show the existing assessment result directly. If pi is 1 (under review) or 3 (certified), do not start the certification flow again.

When pi is 3, also check re_authentication and pi_end_at to decide whether recertification is needed. pending means a recertification has already been submitted, so do not prompt again. un_pass means the recertification was rejected, so guide the Client to submit again. If there is no recertification record and pi_end_at is approaching, tell the Client that the certification is about to expire.

After a risk assessment or PI certification is submitted, the server updates the status with a delay, so an immediate query may still return the previous status. This operation is also used to check the risk level and PI eligibility before fund trading and IPO subscriptions.

When you call this operation through WhaleCore requestService(), you do not need to set requiresTradeToken to true.

GEThttps://api.lbkrs.com/v1/member/ut/states

Parameters

account_channelstringqueryRequired

Broker channel

Responses

HTTP 200The request succeeded. The response body contains the result of the “Get Risk Assessment and Professional Investor Status” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
piinteger

Professional Investor certification status:

  • 0 - Not submitted
  • 1 - Under review
  • 2 - Failed
  • 3 - Certified
Values
0
1
2
3
riskstring

Risk assessment level. A1 to A5 correspond to conservative, moderate, balanced, growth, and aggressive. Empty means the Client has not completed the assessment.

pi_end_atinteger

Expiry time of the PI certification as a Unix timestamp in seconds

re_authenticationstring

Recertification status:

  • pending - Recertification under review
  • un_pass - Recertification rejected
  • Empty string - No recertification record
Whale Docs