> For the complete documentation index, see [llms.txt](https://docs.kavoon.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kavoon.io/onboarding/verify-individual-client.md).

# Verify Individual Client

### Quick reference

1. [Structure of entry info about User](#entry-info-about-user)
2. [Choosing nationality](#choosing-nationality)
3. [Current address](#current-address)
4. [Previous address](#previous-address)

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`

### Entry info about User

At this point, Client shall obtain the following User’s details 

* First name
* Last name
* Birth date
* Email
* Nationality
* Current address (contains sub-items)
* Previous address (contains sub-items)

Please refer to the [API details](#api-reference-submit-users-entry-data) in the end of the article to look up specific constraints to each component

### Choosing nationality

User can select a nationality from the proposed list only. Such list can be retrieved by calling the API below.

## Get nationalities

<mark style="color:blue;">`GET`</mark> `https://api.kavoon.io/api/client-info/dictionary/countries`

This method outputs a list of nationalities basing on a postal code.&#x20;

The request body must be empty.

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
"result":
 [
  {"name" : "Austrian", "code":"AUS", "flag":"🇦🇹" },
  {"name" : "Afghanistan", "code":"AFG", "flag":"🇦🇫"},
  {"name" : "Åland Islands", "code":"ALA", "flag":"🇦🇽"}
 ]
}
```

{% endtab %}
{% endtabs %}

### Current address

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&#x20;

* 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.&#x20;

### Previous address

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&#x20;

## Submit user entry data

<mark style="color:green;">`POST`</mark> `https://api.kavoon.io/api/user-info/save-first-info`

#### Request Body

| Name                                             | Type   | Description                                                                                                                                                                        |
| ------------------------------------------------ | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| lastName<mark style="color:red;">\*</mark>       | String | <p>Min 2, max 15 chars. </p><p>Allowed symbols: - / , \_ – — " ” \` ‘ ’ ' ‘</p>                                                                                                    |
| previousAdsress                                  | String | <p><strong>Object</strong></p><p></p><p>Like <code>currentAddress</code>, <strong>i</strong>t includes params from <code>flat</code> to <code>organisation</code></p>              |
| 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<mark style="color:red;">\*</mark>     | String | <p>E.g. “SW4 6EH”. </p><p>Max 7 chars; min 1 char.</p><p>Chars /  .  ’  \_  • not allowed</p>                                                                                      |
| town<mark style="color:red;">\*</mark>           | String | <p>Max 20 chars; min 1 char. </p><p>Chars /  .  ’  \_  • not allowed.</p><p></p>                                                                                                   |
| street<mark style="color:red;">\*</mark>         | String | <p>Max 40 chars; min 1 char.</p><p>Chars /  .  ’  \_  • not allowed</p>                                                                                                            |
| subOrganisation                                  | String | 2nd level housing unit                                                                                                                                                             |
| building<mark style="color:red;">\*</mark>       | String | <p>Building number.</p><p>Mutually exclusive with <code>housing</code> or may be both.</p><p></p><p>Max 10 chars; min 1 char.</p><p>Chars /  .  ’  \_  • not allowed</p>           |
| housing<mark style="color:red;">\*</mark>        | String | <p>1st level housing unit.</p><p>Mutually exclusive with <code>building</code> or may be both. </p><p></p><p>Max 20 chars; min 1 char. </p><p>Chars /  .  ’  \_  • not allowed</p> |
| flat                                             | String | <p>Max 20 chars; min 1 char. </p><p>Chars /  .  ’  \_  • not allowed</p>                                                                                                           |
| currentAddress<mark style="color:red;">\*</mark> | String | <p><strong>Object</strong></p><p></p><p>It includes params from <code>flat</code> to <code>organisation</code></p>                                                                 |
| nationality<mark style="color:red;">\*</mark>    | String | Regular name of the country e.g. “United Kingdom”, “Congo”, “Vietnam”                                                                                                              |
| email<mark style="color:red;">\*</mark>          | String | Standard format rules (that is recipient name, @ symbol, domain nameTop-level, domain etc)                                                                                         |
| birthDate<mark style="color:red;">\*</mark>      | String | <p>Format: “YYYY-MM-DD”.</p><p>Min: 01-01-1900<strong>.</strong></p><p>Max: current date minus 18 years (age restrictions)</p>                                                     |
| firstName<mark style="color:red;">\*</mark>      | String | <p>Min 2, max 15 chars. </p><p>Allowed symbols: - / , \_ – — " ” \` ‘ ’ ' ‘</p>                                                                                                    |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
  "result": {
    "userInfo": {
      "status": "REGISTER",
      "step": "CONFIRM_RULES",
      "stepExtras": {}
    }
  }
}
```

{% endtab %}
{% endtabs %}

#### Request body <a href="#request" id="request"></a>

```
{
 "openBank": "true"
 "lastName":"Stevenson",
 "firstName":"Robert",
 "birthDate":"1950-11-13",
 "email":"cosmic@gmail.com",
 "nationality":"",
 "currentAddress": {
   "flat":"68",
   "housing":"Shipstones Business Centre",
   "building":"10",
   "subOrganisation":"Giles Cooper Awards",
   "street":"Richmond Rd",
   "organisation":"British Broadcasting Corporation",
   "town":"Bristol",
   "postalCode":"SW4 6EH",
   "country":"UK",
   "countryCode":"GBR"
 },
 "previousAddress": {
   "flat":"68", 
   "housing":"Shipstones Business Centre",
   "building":"10",
   "subOrganisation":"Giles Cooper Awards",
   "street":"Richmond Rd",
   "organisation":"British Broadcasting Corporation",
   "town":"Bristol",
   "postalCode":"SW4 6EH",
   "country":"UK",
   "countryCode":"GBR"
  }
}
```