Skip to content
Compliance Questionnaires

Submit Compliance Questionnaire

Submits a compliance questionnaire filled in by the Client, creates a review ticket, and returns ticket_id. Prerequisites: questionnaire_id has been obtained through GET /v1/kyc/questionnaire/code_exchange. For dynamic questionnaires, show the important notice before submission and have the Client confirm it.

Answers take one of two forms, depending on the questionnaire: the answers array (used by dynamic questionnaires and most others) or the answer map. If there are upload questions, upload the files first to get their keys, put the keys in the value of the answer (comma-separated for multiple files), and list all file keys in attachments.keys.

Side effect: a successful submission creates a review ticket. You can then call POST /v1/account/get_popup_list to guide the Client to the next questionnaire. If the submission fails, show message and keep what the Client entered so they can retry.

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

POSThttps://api.lbkrs.com/v1/kyc/submit_questionnaire

Parameters

x-target-aaidstringheader

AAID of the target account. When the Client has several accounts under the same tenant, it specifies which account the questionnaire belongs to.

Request body application/json

questionnaire_idobjectrequired

Questionnaire ID

answersarray<object>

Answers in array form. Use either this or answer. Leave out questions with empty values.

Child attributes
keystringrequired

For KYC fields, the field_key. For other fields, the question text in the current language.

valuestringrequired

Answer. For non-KYC choice questions, the option text; for KYC fields, the raw value. Join multiple selections with commas. For upload questions, comma-separated file keys.

servicestring

Storage service for upload questions. Pass user.account.

typestring

Answer type:

  • image - Image upload
  • file - File upload
  • ref - KYC field whose options come from a remote data source
refstring

Data source ID when type is ref

answerobject

Answers in map form, keyed by question identifier. Use either this or answers.

attachmentsobject

Attachments. Pass only when files were uploaded.

Child attributes
keysarray<string>

Keys of all uploaded files

servicestring

Storage service. Pass user.account.

Responses

HTTP 200The request succeeded. The response body contains the result of the “Submit Compliance Questionnaire” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
ticket_idinteger

Review ticket ID

Whale Docs