Identity Verification Questionnaire
The Identity Verification questionnaire is the data-exchange contract of the reliance flows: through it, you submit the outcome of the identity verification you have already performed on a customer, so the platform does not run its own IDV.
It exists in two variants with identical questions:
| Questionnaire | Answered for | Used in |
|---|---|---|
| Identity Verification | The Person | KYC Onboarding - reliance flow |
| Corporate identity Verification | The Business Contact (Individual) | KYB Onboarding |
In the corporate flow, every other linked Individual answers the shorter Corporate ID document verification questionnaire instead, consisting of the document type and an ID document upload.
Structure
The questionnaire contains 28 questions in five groups. As with any questionnaire, each answer references the question's value - see Questionnaire and Response for the general mechanism.
Verification outcome
Question value | Type | Required | Notes |
|---|---|---|---|
verification_id | text | yes | Your reference for the verification session. |
verification_date | datetime | yes | When the verification was performed. |
method | single choice | yes | video_ident, auto_ident, qes_bankident, eid |
status | single choice | yes | completed, failed, fraud |
Verified personal data
Question value | Type | Required |
|---|---|---|
first_name | text | yes |
last_name | text | yes |
date_of_birth | date | yes |
nationality | country | yes |
country_of_birth | country | no |
place_of_birth | text | no |
ID document data
All optional - provide them when the verification was based on an identity document:
Question value | Type | Notes |
|---|---|---|
type | single choice | passport, id_card, residence_permit |
document_number | text | |
issuing_country | country | |
issuing_authority | text | |
issue_date | date | |
expiry_date | date |
QES Bank Ident data
All optional - provide them when the verification method is qes_bankident:
Question value | Type |
|---|---|
iban | text |
reference | text |
account_name | text |
bank_name | text |
bank_country | country |
transfer_date_time | datetime |
Supporting documents
Six optional questions of type multiple_documents. Each expects the IDs of previously uploaded documents whose category matches the question's value:
Question value | Content |
|---|---|
id_document | Copies of the identity document. |
residence_permit | Residence permit, where applicable. |
selfie | Selfie captured during your verification. |
cdd_report | Your customer due diligence report. |
periodic_review | Your most recent periodic review. Expected when the verification_date is more than 2 years in the past - the periodic review demonstrates that the customer relationship has been kept under review since the original verification. |
undetermined | Any other supporting document. |
Answering
- Upload the files first -
POST /persons/{person_id}/documents(orPOST /individuals/{individual_id}/documentsin the corporate flow) - using the matchingcategoryfor each file. - Submit a single response containing the answers and the document IDs.
Submit the questionnaire once, complete. The verification outcome and personal data groups are always required; the ID document, QES Bank Ident, and supporting-document groups depend on the verification method you used - and on the verification's age: when the verification_date lies more than 2 years in the past, include a periodic_review document.