As soon as the applicant completes the questionnaire, all of the answers and uploaded files are added to their profile.

There are two ways of how to view the answers, which are described below.

Review answers in the Dashboard

You can open the Applicants page and filter your applicants by the level name to which you assigned the questionnaire. Then select any applicant profile and open the Questionnaire section to see the submitted answers.

Review answers via API

You can get the answers and files via this API method (see the questionnaire section).

Items with the type of fileAttachment contain the imageId value that you can use to fetch the uploaded files.

The following is a response example:

{
    "id": "applicantId",
    "createdAt": "2024-10-15 14:05:35",
    "key": "yourKey",
    "clientId": "yourClientId",
    "inspectionId": "someId",
    "externalUserId": "userId",
    "info": {},
    "fixedInfo": {
        "residenceCountry": "USA"
    },
    "applicantPlatform": "Web",
    "authCode": "authCodeValue",
    "agreement": {
        "createdAt": "2024-10-15 14:05:42",
        "acceptedAt": "2024-10-15 14:05:42",
        "source": "WebSDK",
        "recordIds": [
            "id"
        ]
    },
    "requiredIdDocs": {
        "docSets": [
            { // Questionnaire is required to applicant
                "idDocSetType": "QUESTIONNAIRE",
                "questionnaireDefId": "ExampleQuestionnaire"
            }
        ]
    },
    "review": {
        "reviewId": "someId",
        "attemptId": "someId",
        "attemptCnt": 1,
        "elapsedSincePendingMs": 240,
        "elapsedSinceQueuedMs": 240,
        "reprocessing": true,
        "levelName": "basic-kyc-level",
        "levelAutoCheckMode": null,
        "createDate": "2024-10-15 14:07:49+0000",
        "reviewDate": "2024-10-15 14:07:50+0000",
        "reviewResult": {
            "reviewAnswer": "GREEN"
        },
        "reviewStatus": "completed",
        "priority": 0
    },
    "lang": "en",
    "type": "individual",
    "questionnaires": [ // Questionnaire data from applicant
        {
            "id": "ExampleQuestionnaire",
            "sections": { // Questionnaire sections
                "section1Id": {
                    "score": 0.0,
                    "items": { // Questions within the section
                        "dateId": {
                            "value": "2024-10-10"
                        },
                        "phoneNumberId": { // Question ID
                            "value": "+447400123456" // Client answer to the question
                        },
                        "shortAnswerWithFormat": {
                            "value": "[email protected]"
                        },
                        "countryId": {
                            "value": "GBR"
                        },
                        "shortAnswerId": {
                            "value": "John Doe"
                        }
                    }
                },
                "section2Id": {
                    "score": 24.0, // Sum of the question's risk scores in the section
                    "items": {
                        "dropdownId": {
                            "value": "drop_option1Id",
                            "score": 5.0,
                            "dataScores": [
                                {
                                    "value": "drop_option1Id",
                                    "score": 5.0 // Client answer's risk score if applicable
                                }
                            ]
                        },
                        "paragraphId": {
                            "value": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud "
                        },
                        "dateAndTimeId": {
                            "value": "2024-10-15T16:07"
                        },
                        "checkboxesId": {
                            "values": [
                                "check_option2Id"
                            ],
                            "score": 12.0,
                            "dataScores": [
                                {
                                    "value": "check_option2Id",
                                    "score": 12.0
                                }
                            ]
                        },
                        "multichoiceId": {
                            "value": "radio_option1Id",
                            "score": 7.0,
                            "dataScores": [
                                {
                                    "value": "radio_option1Id",
                                    "score": 7.0
                                }
                            ]
                        }
                    }
                },
                "section3Id": {
                    "score": 0.0,
                    "items": {
                        "consentId": {
                            "value": "true"
                        },
                        "fileUploadId": {
                            "value": "381914678"
                        },
                        "multiFileUploadId": {
                            "values": [
                                "1164252192",
                                "1041427802"
                            ]
                        }
                    }
                }
            },
            "score": 24.0 // Total questionnaire risk score
        }
    ]
}

API example answers to each type of questions

Every questionnaire section is represented by its own unique ID and contains:

score — sum of all question risk scores within the section.
items — object with questions within the section.

"sectionId":{
   "score":0.0,
   "items":{...}
}

Below, you can see the example answers to each type of questions as they are presented in the API response.

Text answers

// Plain text answer

"shortAnswerId": {
   "value":"27"
}

// Answer in the expandable text area.
// The same as a short answer in terms of API response representation.

"paragraphId":{
   "value":"text"
}

Variant answers

// Response includes:
//   • 'values' — IDs of selected checkbox items.
//   • 'score' — total score of all selected items.
//   • 'dataScores' — score of each checkbox item selected by an applicant.

"checkboxesId":{
   "values":[
      "valueId1",
      "valueId2",
   ],
   "score":11.0,
   "dataScores":[
      {
         "value":"valueId2",
         "score":6.0
      },
      {
         "value":"valueId1",
         "score":5.0
      }
   ]
}

// Response includes:
//   • 'value' — ID of the selected radio button item.
//   • 'score' and 'dataScores' — score of the selected item. The only difference is that 'dataScores' also contains a 'value'.

"multiplechoiceId":{
   "value":"valueId2",
   "score":10.0,
   "dataScores":[
      {
         "value":"valueId2",
         "score":10.0
      }
   ]
}

// Response includes:
//   • 'value' — ID of the selected dropdown item.
//   • 'score' and 'dataScores' — score of the selected item. The only difference is that 'dataScores' also contains a 'value'.

"dropdownId":{
   "value":"valueId2",
   "score":10.0,
   "dataScores":[
      {
         "value":"valueId2",
         "score":10.0
      }
   ]
}

Phone number submission

// Applicant selects a country code and enters the phone number, which is then converted into a single string in the response.

"phoneNumberId":{
   "value":"+441234567890"
}

Country select

// Applicant selects a country from the dropdown by its full name, which is then converted into the ISO 3166-1 alpha-3 country code.

"citizenshipCountryId":{
   "value":"SRB"
}

// Applicant selects several countries from the dropdown by their full names, which are then converted into the ISO 3166-1 alpha-3 country code.

"multipleCitizenshipCountryIds":{
   "values":[
      "PRT",
      "ESP"
   ]
}

File upload

// Contains the 'imageId' value that you can use to fetch the uploaded file.

"fileUploadId":{
   "value":"381914678"
}

// For cases when multi upload is allowed.
// Contains the 'imageId' values that you can use to fetch the uploaded files.

"multiFileUploadId":{
   "values":[
      "1164252192",
      "1041427802"
   ]
}

Date and time

// Selected date is represented in the 'yyyy-mm-dd' format.

"dateId":{
   "value":"2024-10-11"
}

// Selected date and time are represented in the 'yyyy-mm-ddTHH:MM' format:

"dateAndTimeId":{
   "value":"2024-10-13T21:59"
}

Consent (Agreement)

// If an applicant approves the consent in the questionnaire.

"consentId":{
   "value":"true"
}

// If an applicant declines the consent in a questionnaire and that consent is optional.

"consentId":{
   "value":"false"
}

Optional question with no answer

// If a question is optional and an applicant does not provide an answer, the field contains no value.

"shortAnswerId": {}