Skip to main content

CreateApplicantDto

externalUserIdstringrequired

Identifier of the applicant in your system. It must be unique: the request is rejected if an applicant with this identifier already exists. Use it later instead of the internal ID to get the applicant.

flowNamestringrequired

Name of the verification flow the applicant has to pass. The flow must exist in your company.

phonestring

Phone number of the applicant. The request is rejected if the phone belongs to another applicant.

emailstring

Email address of the applicant. The request is rejected if the email belongs to another applicant.

langstring

The language, in which the verification results should be displayed to applicants.

suppliedInfo object

Data about the applicant that you already have. It is compared with the data extracted from the applicant documents during the verification.

firstNamestring

The first name of the applicant.

lastNamestring

The last name of the applicant.

middleNamestring

The middle name of the applicant.

genderstring

An applicant gender (M or F).

dobstring

Applicant date of birth (format YYYY-mm-dd, e.g. 2001-09-25).

placeOfBirthstring

The applicant birthplace.

countryOfBirthstring

Applicant country of birth.

stateOfBirthstring

Applicant state of birth.

countrystring

Alpha-3 country code (e.g. DEU or GBR).

nationalitystring

Alpha-3 country code of the applicant nationality.

addresses object[]

List of applicant addresses.

  • Array [
  • countrystring

    Alpha-3 country code.

    postCodestring

    Postal code.

    townstring

    Town or city name.

    streetstring

    Street name.

    statestring

    State name.

    buildingNamestring

    Building name.

    flatNumberstring

    Flat or apartment number.

    buildingNumberstring

    Building number.

  • ]
  • CreateApplicantDto
    {
    "externalUserId": "string",
    "flowName": "string",
    "phone": "string",
    "email": "string",
    "lang": "string",
    "suppliedInfo": {
    "firstName": "string",
    "lastName": "string",
    "middleName": "string",
    "gender": "string",
    "dob": "string",
    "placeOfBirth": "string",
    "countryOfBirth": "string",
    "stateOfBirth": "string",
    "country": "string",
    "nationality": "string",
    "addresses": [
    {
    "country": "string",
    "postCode": "string",
    "town": "string",
    "street": "string",
    "state": "string",
    "buildingName": "string",
    "flatNumber": "string",
    "buildingNumber": "string"
    }
    ]
    }
    }