Skip to content
Fund Trading

Get Fund Order Certification Checks

Returns the certification checks the Client must see or resolve before ordering the fund, such as Professional Investor (PI) certification, derivative knowledge assessment, investment concentration, or risk disclosure. For a buy, call it after Validate Fund Order Risk returns user_pi of 2, and show each msg in turn, offering navigation when link is present. If any item has is_force set to true, stop and do not call Submit Fund Order. An empty list means no further action is needed. Also used to check eligibility before creating or modifying a recurring investment plan, to check PI certification before opening the private fund list, and before a cash management sell.

When you call this endpoint through WhaleCore requestService(), set requiresTradeToken to true.

GEThttps://api.lbkrs.com/ut/order/validation

Parameters

counter_idstringqueryRequired

Fund ID (counter_id), a fund code in the form UT/HK/...

actionstringqueryRequired

Trade direction:

  • BUY - Buy (subscription)
  • SELL - Sell (redemption)

BUYSELL

amountstringquery

Buy amount. Pass it when ordering by amount

unitsstringquery

Sell units. Pass it when selling by units

x-target-aaidstringheader

The aaid of the target fund account. Broker App passes the fund account the Client currently selects

Responses

HTTP 200The request succeeded. The response body contains the result of the “Get fund order certification checks” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
listarray<object>

Checks in display order. Empty means nothing to resolve

Child attributes
keystring

Check identifier. Values observed in the source:

  • risk_assessment - Risk assessment not completed
  • risk_assessment_expired - Risk assessment expired
  • risk_assessment_pending - Risk assessment under review
  • pi - Professional Investor (PI) certification required
  • ai - Accredited investor certification required
  • derivative - Derivative knowledge assessment
  • invest_period - Investment horizon match
  • invest_concentration - Investment concentration notice
  • risk_disclosure - Product risk disclosure
msgstring

Prompt text that you can show to the Client as is

linkstring

URL of the page that resolves the check, such as a certification or assessment page. If empty, show the prompt only

is_forceboolean

Whether the check is mandatory. true means the Client cannot continue placing the order until the check is resolved

stylestring

Display style identifier

HTTP 400The service rejected the request because a business rule or input validation failed. Review the business codes and correct the request before retrying.
codeintegerrequired

Business status code, 0 indicates success

messagestringrequired

Human-readable result or error message.

Whale Docs