Verify Individual Client
Last updated
Last updated
The purpose of this step is to collect minimal information about User such as a name, birth date, address etc. It’s triggered by step: ENTRY_DATASET
At this point, Client shall obtain the following User’s details
First name
Last name
Birth date
Nationality
Current address (contains sub-items)
Previous address (contains sub-items)
User can select a nationality from the proposed list only. Such list can be retrieved by calling the API below.
GET https://api.kavoon.io/api/client-info/dictionary/countries
This method outputs a list of nationalities basing on a postal code.
The request body must be empty.
The full list of address components is described in API details below.
So that User doesn't fill out all of the fields manually, Client might pre-fill them automatically. For this purpose, he should
ask User for a postal code
send it to API details below
retrieve the list of result addresses
ask User to select one
pre-fill the fields with the respective components of the selected address
However, there is always a chance of no results found. In this case, User has to enter the data manually.
Provided User has specified that he lived at the current address for less than six months, he shall submit his previous address. The required components are described in the API details below.
As in the previous case, Client might pre-fill the fields with components
POST https://api.kavoon.io/api/user-info/save-first-info
lastName*
String
Min 2, max 15 chars.
Allowed symbols: - / , _ – — " ” ` ‘ ’ ' ‘
previousAdsress
String
Object
Like currentAddress, it includes params from flat to organisation
organisation
String
1st level organisation
countryCode
String
Country code. If null then GBR by default.
country
String
If null then United Kingdom by default
postalCode*
String
E.g. “SW4 6EH”.
Max 7 chars; min 1 char.
Chars / . ’ _ • not allowed
town*
String
Max 20 chars; min 1 char.
Chars / . ’ _ • not allowed.
street*
String
Max 40 chars; min 1 char.
Chars / . ’ _ • not allowed
subOrganisation
String
2nd level housing unit
building*
String
Building number.
Mutually exclusive with housing or may be both.
Max 10 chars; min 1 char.
Chars / . ’ _ • not allowed
housing*
String
1st level housing unit.
Mutually exclusive with building or may be both.
Max 20 chars; min 1 char.
Chars / . ’ _ • not allowed
flat
String
Max 20 chars; min 1 char.
Chars / . ’ _ • not allowed
currentAddress*
String
Object
It includes params from flat to organisation
nationality*
String
Regular name of the country e.g. “United Kingdom”, “Congo”, “Vietnam”
email*
String
Standard format rules (that is recipient name, @ symbol, domain nameTop-level, domain etc)
birthDate*
String
Format: “YYYY-MM-DD”.
Min: 01-01-1900.
Max: current date minus 18 years (age restrictions)
firstName*
String
Min 2, max 15 chars.
Allowed symbols: - / , _ – — " ” ` ‘ ’ ' ‘
Please refer to the in the end of the article to look up specific constraints to each component