Skip to content

Creating a new client

POST

The client creation process takes place in two stages:

  1. Initializing a new client .

-> 2. Create a new client.

When creating a new client, you need to extract the entire body returned by the initialization method of the new client into the request body. In the body of the request, you need to enter data about the client:

  • ** firstName ** - name,

  • ** lastName ** - last name,

  • ** sexId ** - gender ,

  • ** birthDate ** - date of birth in YYYY-MM-DD format,

  • ** passport ** (passport.seria, passport.no, passport.issueDate) - passport data (passport series, passport number, passport issue date in YYYY-MM-DD format)

  • ** mobilePhone ** - mobile phone number in digital form of international format (eg 89031001112, 37369123456)

  • ** managerId ** - client manager ID

  • ** addressData ** ( addressData.fias , addressData.fullAddressText) - actual address

  • ** registrationAddressData ** (registrationAddressData.fias, registrationAddressData.fullAddressText) - registration address

You can transfer a completely filled address structure as client addresses, or you can specify only two fields - FIAS code and an address string (including apartment number ), and all other fields will be filled in automatically.

The trigger for sending a separate request to clarify the address is the filled FIAS code and address line fields, as well as the empty fiasChainText field

The minimum set of fields to fill in the request body from the previous list are: firstName, lastName, sexId, birthDate, passport.seria, passport.no, passport.issueDate, mobilePhone, addressData.fias , addressData.fullAddressText. The managerId field (you can find it out in the reference books - loan specialist ) is already filled with a default value during client initialization

Request Body

application/json
object

Chief Accountant

Activity subtype identifier , this link can be used to get "Activities", which in their queue can contain activity subtypes

Format"int64"
Format"int64"

other expenses

Format"double"

Additional income

Format"double"
object

Additional Information

Alimony Yes / No

Scheduled inspection date in the format YYYY-MM-DD

Format"date"

Conviction Yes / No

Are there any restrictions on the right to conclude a loan transaction (including a marriage contract) Yes / No

The risk of using public services (risk of involvement) for the purpose of legalizing (laundering) proceeds from crime and financing terrorism

Are there or have been in the past court decisions limiting the client's legal capacity or establishing guardianship over the client? Yes / No

Please enter a title

Results of checking the client, client's representative, beneficiary, beneficial owners for the presence / absence of a close relationship to a person included in the list of Extremists

Information (documents) on the financial position

Resident Yes / No

Date of registration of the Questionnaire of the client, client's representative, beneficiary, beneficial owners in the YYYY-MM-DD format

Format"date"
object[]

Dates of updating the client's questionnaire

object[]

Provided sureties

You have already contacted banks Yes / No

Additional information identifier

Format"int64"

Lawsuits Yes / No

Client license information

Origin of funds

Is the client a manager, founder or employee of public organizations and associations (religious organizations, political parties, organizations, associations), foundations, foreign non-profit non-governmental organizations, their branches and representative offices operating in the territory of the Russian Federation

Pregnancy Yes / No

object[]

Personal property - apartment

Registered with a psychiatrist or narcologist Yes / No

Information about the client's (his relatives, indicating the degree of relationship or status), beneficial owners (his relatives, indicating the degree of relationship or status) to a foreign public official

Results of checking the registration address (location or place of residence) of the client, the client's representative, beneficiary, beneficial owners in the country / region / subject with a high risk of terrorist and extremist manifestations, interethnic conflicts, armed conflicts and hostilities

Risk degree

Format"int64"

Are there any taxes and duties arrears Yes / No

Are there any overdue debts?

object[]

Personal property - car

Additional telephone number in digital form in international format (e.g. 74951001112, 37369123456)

object

Residence address (for legal entities Actual address)

Apartment number

object

Building number

Building number

Format"int64"
object

The FIAS address chain. This parameter is optional. When creating a client, you can choose not to transfer

JSON URL string

Address chain

FIAS address string

House number

Housing type

Residence Address ID

Format"int64"

District

Nearest metro station

An outdated address, for example, an old street name in a passport. Used for informational purposes only!

Postal Code

Registration date in YYYY-MM-DD format

Format"date"

Scope

Locality, street, house

Landline telephone in digital form of international format (e.g. 74951001112, 37369123456)

object[]

Collection of additional addresses

Apartment number

object

Building number

Building number

Country identifier

Format"int64"
object

FIAS address chain

JSON URL string

FIAS code (street level)

FIAS address string

House number

Housing type

Additional address identifier

Format"int64"

Name of the settlement

Nearest metro station

The string of the address entered manually (not the actual address as in the passport)

Index of the position of the address in the collection of additional addresses

Format"byte"

Postal Code

Address assignment (registration, place of work, etc.)

Format"int64"

Registration date in YYYY-MM-DD format

Format"date"

Scope

Street name

Landline telephone in digital form of international format (e.g. 74951001112, 37369123456)

Alimony

Format"double"

Car availability Yes / No

Availability of real estate

Average monthly expenses

Format"double"
object[]

Collection of beneficial owners. Beneficial owner (also beneficial owner) is a person or several persons who directly or indirectly own a legal entity or have a significant influence on its decision-making. (see also here )

Object identifier within the collection of beneficialOwners

Format"int64"

Customer ID who, based on substantiation justification, should be considered the beneficial owner

Format"int64"

Rationale. On the basis of which, it was decided to consider the beneficial owner with the given ownerId as such

Citizenship ID obtained from "Countries" directory

Format"int64"

Date of birth in YYYY-MM-DD format

Format"date"

Place of Birth

Prizes

Format"double"

Flag of consent to transfer given to credit bureau Yes / No

Date of consent to transfer data to the credit bureau in the format YYYY-MM-DD

Format"date"
object

Workplace address

Apartment number

object

Building number

Building number

Format"int64"
object

The FIAS address chain. This parameter is optional. When creating a client, you can choose not to transfer

JSON URL string

Address chain

FIAS address string

House number

Housing type

Residence Address ID

Format"int64"

District

Nearest metro station

An outdated address, for example, an old street name in a passport. Used for informational purposes only!

Postal Code

Registration date in YYYY-MM-DD format

Format"date"

Scope

Locality, street, house

Landline telephone in digital form of international format (e.g. 74951001112, 37369123456)

Business owner Yes / No

IP sign Yes / No. According to the law of the Russian Federation, an individual entrepreneur (IP) is a physical. face. If the client is an individual entrepreneur, then this field and the naturalperson field are true. For legal entities persons (for example LLC) values ​​for the fields businessman and naturalperson are passed false

Bankcard number

object

Activity certificate

Format"int64"

Expiration date in YYYY-MM-DD format

Format"date"

Founder's document type identifier : - 102121 - Driver's license - 102122 - SNILS - 102123 - Foreign passport - 102126 - Passport - 102127 - Other document - 102128 - No Currently, although this parameter is present, it will have the null value in the passport,

because there is a complementaryDoc object that contains the complementaryDocTypeId parameter, which has a value (see the description of this parameter above)

Format"int64"

Additional number

Certificate ID

Format"int64"

Date of issue in YYYY-MM-DD format

Format"date"

Issued by

Certificate number

Certificate Series

Department code

Type Certificate

Format"int64"

Has your full name changed Yes / No

Reason for changing name

The size of the authorized capital or authorized capital

Of them adult children

Format"int64"

Children's age

No. of children

Format"int64"

Agent

Format"int64"
object[]

Client risk status

Client risk status Comment

Client's risk status identifier

Format"int64"

Customer Risk Status Date in YYYY-MM-DD format

Format"date-time"

Client risk status Username

Format"int32"

Client risk status

Format"int64"

Client type - BORROWER - Borrower - COBORROWER - Co-borrower - GUARANTOR - Guarantor - PLEDGER - Pledger - DEPOSITOR - Investor - REPRESENTATIVE - Client's representative - BENEFICIARY - Beneficiary

Valid values"BENEFICIAL_OWNER""BENEFICIARY""BORROWER""COBORROWER""DEPOSITOR""GUARANTOR""PLEDGER""REPRESENTATIVE"

Comment

object

Additional documents

Format"int64"

Validity of add. document in YYYY-MM-DD format

Format"date"

Additional document type. Record ID in the "Document Type " reference

Format"int64"

Additional identifier document. When creating a new client, null is written, the number is assigned automatically

Format"int64"

Date of issue add. document in YYYY-MM-DD format

Format"date"

Issued by add. document

Additional number document

Creation date in YYYY-MM-DD format

Format"date"

Current credit limit

Format"double"

Maximum credit limit

Format"double"
Format"date"

Are you a dependent? Well no

Number of dependents

Format"int32"

Director

Education ID obtained from "Education" reference

Format"int64"

E-mail address

Number of employees

Format"int32"

Date of termination of the relationship with the customer in the format YYYY-MM-DD

Format"date"
object[]

Additional field identifier

Format"int64"

The name of the additional field.

If you want the variables from the lead to be taken from the lead to the client / application / contract during the operation of the decision making system (DSS),

then you need to transfer them as follows: - client.field_name - for placing a field in the client - loanApplication.field_name - for placing a field in an application - contract.field_name - for placing a field in a contract

Additional field value

Faculty

Fax

Name

Foreign organization code

Registration number in the country of registration

Organization name in a foreign language

Group id

Format"int64"

Identifier of an entry in the directory "Position of the head"

Format"int64"

University

Home telephone number in digital form in international format (e.g. 74951001112, 37369123456)

ID of the entry in the directory "How did you hear about us?"

Format"int64"

Client ID. When creating a new client, null is written, the ID is assigned automatically

Format"int64"

Even list Yes / No

On the email list

Red List Yes / No

In the SMS mailing list Yes / No

Investor Yes / No

Client join date in YYYY-MM-DD format

Format"date"

The manager acts on the basis

Checkpoint

object
Format"int32"
Format"int32"
Format"int32"
Format"int32"
Format"int32"
Format"int32"
Format"int64"
Format"int32"
Format"int32"

Surname

Old name in Latin

Old surname in Latin

Old patronymic in Latin

Reason for termination of membership

Format"int64"

Organizational and legal form

object

Document confirming the right to stay on the territory of the Russian Federation

Format"int64"

Expiration date in YYYY-MM-DD format

Format"date"

Founder's document type identifier : - 102121 - Driver's license - 102122 - SNILS - 102123 - Foreign passport - 102126 - Passport - 102127 - Other document - 102128 - No Currently, although this parameter is present, it will have the null value in the passport,

because there is a complementaryDoc object that contains the complementaryDocTypeId parameter, which has a value (see the description of this parameter above)

Format"int64"

Additional number

Certificate ID

Format"int64"

Date of issue in YYYY-MM-DD format

Format"date"

Issued by

Certificate number

Certificate Series

Department code

Loan payments

Format"double"

Maiden name

ID of an entry from the "Loan Specialist" directory

Format"int64"

Marital Status Identifier - 101151 - SINGLE - 101152 - MARRIED - 101153 - DIVORCED ( Divorced / Divorced) - 101154 - WIDOW (Widow / Widow) - 101155 - CIVIL_MARRIAGE (Civil marriage)

Format"int64"

Average monthly income

Format"double"
object

Migration card

Format"int64"

Expiration date in YYYY-MM-DD format

Format"date"

Founder's document type identifier : - 102121 - Driver's license - 102122 - SNILS - 102123 - Foreign passport - 102126 - Passport - 102127 - Other document - 102128 - No Currently, although this parameter is present, it will have the null value in the passport,

because there is a complementaryDoc object that contains the complementaryDocTypeId parameter, which has a value (see the description of this parameter above)

Format"int64"

Additional number

Certificate ID

Format"int64"

Date of issue in YYYY-MM-DD format

Format"date"

Issued by

Certificate number

Certificate Series

Department code

Is your mobile phone number registered to you?

Mobile phone number in digital form in international format (e.g. 79031001112, 37369123456)

Monthly income for 2NDFL

Format"double"

Average monthly pension

Format"double"

Monthly net profit

Format"double"

SME (Small / Medium Enterprise)

Natural person attribute Yes / No

OKATO

OKFS

OKOGU

OKOPF

OKTMO

OKVED

Old name

Old surname

Old passport

Old patronymic

Initial experience (before joining the program) in months:

Format"int32"
object

The passport

Format"int64"

Expiration date in YYYY-MM-DD format

Format"date"

Founder's document type identifier : - 102121 - Driver's license - 102122 - SNILS - 102123 - Foreign passport - 102126 - Passport - 102127 - Other document - 102128 - No Currently, although this parameter is present, it will have the null value in the passport,

because there is a complementaryDoc object that contains the complementaryDocTypeId parameter, which has a value (see the description of this parameter above)

Format"int64"

Additional number

Certificate ID

Format"int64"

Date of issue in YYYY-MM-DD format

Format"date"

Issued by

Certificate number

Certificate Series

Department code

middle name

Format"int64"
object[]

Customer accounts

Account number

Bank ID

Format"int64"

Name of the bank. The field is needed in case the bank is not selected from the directory, but is indicated on the client accounts page

BIK

Availability of a file cabinet

Comments

Cor. score

Format"int64"

Recipient's TIN

Average monthly account turnover

Account opening date in YYYY-MM-DD format

Format"date"

Recipient

object[]

Founders

Format"int64"

Date of birth of the founder

Format"date"

Founder ID

Format"int64"

Founder's mobile phone

Full name of the founder

Founder's passport details

object

Founder's passport

Founder Position ID

Format"int64"

Founder's registration address

Resident

Founder's share

Format"double"

Founder's office phone number

object[]

Income

Amount

Format"double"

Income ID

Format"int64"

Income type identifier

Format"int64"

Information (comment)

object[]

List of relatives

Relative address

Relative's date of birth (YYYY-MM-DD)

Format"date"

Affinity identifier : - 102141 - Wife - 102142 - Husband - 102143 - Mom - 102144 - Dad - 102145 - Daughter - 102146 - Son - 102147 - Brother - 102148 - Sister - 102149 - Colleagues - 1021410 - Friends - 1021411 - Grandmother - 1021412 - Grandfather - 1021413 - Uncle - 1021414 - Aunt - 1021415 - Other

Format"int64"

Comments by relatives

Relative email

Relative name

Relative ID

Format"int64"

Relative surname

object

Relative's passport

Relative patronymic

Resident

TIN of a relative

Relative phone number

Verified

A relative's place of work

Personal account

Data processing consent flag Yes / No

Date of consent to data processing in YYYY-MM-DD format

Format"date"

Pin

Profession identifier obtained from "Professions" directory

Format"int64"

Rating

Valid values"APPROVE""DENY""GOOD""MEDIUM""TECH_FAULT""UNDEFINED""VALIDATION_ERROR"

Rating date in YYYY-MM-DD format

Format"date"
object

Registration address (for legal entities Legal address)

Apartment number

object

Building number

Building number

Format"int64"
object

The FIAS address chain. This parameter is optional. When creating a client, you can choose not to transfer

JSON URL string

Address chain

FIAS address string

House number

Housing type

Residence Address ID

Format"int64"

District

Nearest metro station

An outdated address, for example, an old street name in a passport. Used for informational purposes only!

Postal Code

Registration date in YYYY-MM-DD format

Format"date"

Scope

Locality, street, house

Landline telephone in digital form of international format (e.g. 74951001112, 37369123456)

object

OGRNIP

Format"int64"

Expiration date in YYYY-MM-DD format

Format"date"

Founder's document type identifier : - 102121 - Driver's license - 102122 - SNILS - 102123 - Foreign passport - 102126 - Passport - 102127 - Other document - 102128 - No Currently, although this parameter is present, it will have the null value in the passport,

because there is a complementaryDoc object that contains the complementaryDocTypeId parameter, which has a value (see the description of this parameter above)

Format"int64"

Additional number

Certificate ID

Format"int64"

Date of issue in YYYY-MM-DD format

Format"date"

Issued by

Certificate number

Certificate Series

Department code

Rental income

Format"double"

Resident Yes / No

INN

Role ID

Format"int64"
object[]

Current loans and borrowings

The presence of delays in an existing loan or loan

Bank of an active loan or loan

Number / Date of the current credit or loan agreement

The amount of the current loan or loan

Format"double"

Object identifier bank of active credit or loan

Format"int64"

The name of the current loan or loan

Current loan or loan identifier

Format"int64"

Interest rate of an active loan or loan

Format"double"

Date of the last actual payment on an active loan or loan in the format YYYY-MM-DD

Format"date"

Monthly payment of an existing loan or loan

Format"double"

Frequency of payments of an existing loan or loan

Remaining debt of the current loan or loan

Format"double"

Details of a valid loan or loan

Gender

Format"int64"

Shareholder

Abbreviated name of the organization

SMS history

SNILS

Form of study

Year of graduation

OKPO code (for legal entities)

Name of company

Validity - month

Validity - year

object

Work place information

Activity type. Record identifier in "Activities" reference

Format"int64"

Comment

I don't work for a reason

Second employee's phone number

Director's telephone number in digital form in international format (e.g. 74951001112, 37369123456)

Executive phone number in digital form of international format (e.g. 74951001112, 37369123456)

Colleague's phone number in digital form in international format (e.g. 74951001112, 37369123456)

Additional telephone in digital form of international format (e.g. 74951001112, 37369123456)

Format"int64"
Format"int64"

Workplace information identifier

Format"int64"

TIN of the organization

Date of next salary in YYYY-MM-DD format

Format"date"

previous place of work

Job website

Experience

International digital work phone (e.g. 74951001112, 37369123456)

Place of work

Job type

Format"int64"

Position

Job type

Format"int64"

Employment date in YYYY-MM-DD format

Format"date"

Responses

OK

*/*
object
object

Chief Accountant

Activity subtype identifier , this link can be used to get "Activities", which in their queue can contain activity subtypes

Format"int64"
Format"int64"

other expenses

Format"double"

Additional income

Format"double"
object

Additional Information

Additional telephone number in digital form in international format (e.g. 74951001112, 37369123456)

object

Residence address

object[]

Alimony

Format"double"

Car availability Yes / No

Availability of real estate

Average monthly expenses

Format"double"
object[]

Collection of beneficial owners. Beneficial owner (also beneficial owner) is a person or several persons who directly or indirectly own a legal entity or have a significant influence on its decision-making. (see also here )

Citizenship ID obtained from "Countries" directory

Format"int64"

Date of birth in YYYY-MM-DD format

Format"date"

Place of Birth

Prizes

Format"double"

Flag of consent to transfer given to credit bureau Yes / No

Date of consent to transfer data to the credit bureau in the format YYYY-MM-DD

Format"date"
object

Address of the place of work

Business owner Yes / No

IP sign Yes / No. According to the law of the Russian Federation, an individual entrepreneur (IP) is a physical. face. If the client is an individual entrepreneur, then this field and the naturalperson field are true. For legal entities persons (for example LLC) values ​​for the fields businessman and naturalperson are passed false

Bankcard number

object

Activity certificate

Type Certificate

Format"int64"

Has your full name changed Yes / No

Reason for changing name

The size of the authorized capital or authorized capital

Of them adult children

Format"int64"

Children's age

No. of children

Format"int64"

Agent

Format"int64"
object[]

Client risk status

Client type - BORROWER - Borrower - COBORROWER - Co-borrower - GUARANTOR - Guarantor - PLEDGER - Pledger - DEPOSITOR - Depositor - REPRESENTATIVE - Client Representative - BENEFICIARY - Beneficiary - BENEFICIAL_OWNER - Beneficial Owner

Valid values"BENEFICIAL_OWNER""BENEFICIARY""BORROWER""COBORROWER""DEPOSITOR""GUARANTOR""PLEDGER""REPRESENTATIVE"

Comment

object

Additional documents

Unit ID

Format"int64"

User ID

Format"int32"

Creation date in YYYY-MM-DD format

Format"date"

Current credit limit

Format"double"

Maximum credit limit

Format"double"
Format"date"

Are you a dependent? Well no

Number of dependents

Format"int32"

Director

Education ID obtained from "Education" reference

Format"int64"

E-mail address

Number of employees

Format"int32"

Date of termination of the relationship with the customer in the format YYYY-MM-DD

Format"date"
object[]

Faculty

Fax

Name

Foreign organization code

Registration number in the country of registration

Organization name in a foreign language

Group id

Format"int64"

Identifier of an entry in the directory "Position of the head"

Format"int64"

University

Home telephone number in digital form in international format (e.g. 74951001112, 37369123456)

ID of the entry in the directory "How did you hear about us?"

Format"int64"

Client ID. When creating a new client, null is written, the number is assigned automatically

Format"int64"

Even list Yes / No

On the email list

Red List Yes / No

In the SMS mailing list Yes / No

Investor Yes / No

Client join date in YYYY-MM-DD format

Format"date"

The manager acts on the basis

Checkpoint. Field for a client-legal entity

object
Format"int32"

Surname

Old name in Latin

Old surname in Latin

Old patronymic in Latin

Reason for termination of membership

Format"int64"

Organizational and legal form

object

Document confirming the right to stay on the territory of the Russian Federation

Loan payments

Format"double"

Maiden name

ID of an entry from the "Loan Specialist" directory

Format"int64"

Marital Status Identifier - 101151 - SINGLE - 101152 - MARRIED - 101153 - DIVORCED ( Divorced / Divorced) - 101154 - WIDOW (Widow / Widow) - 101155 - CIVIL_MARRIAGE (Civil marriage)

Format"int64"

Average monthly income

Format"double"
object

Migration card

Is your mobile phone number registered to you?

Mobile phone number in digital form in international format (e.g. 79031001112, 37369123456)

Monthly income for 2NDFL

Format"double"

Average monthly pension

Format"double"

Monthly net profit

Format"double"

SME (Small / Medium Enterprise)

Natural person attribute Yes / No

OKATO

OKFS

OKOGU

OKOPF

OKTMO

OKVED

Old name

Old surname

Old passport

Old patronymic

Initial experience (before joining the program) in months:

Format"int32"
object

The passport

middle name

Format"int64"
object[]

Customer accounts

object[]

Founders

object[]

Income

object[]

List of relatives

Personal account

Data processing consent flag Yes / No

Date of consent to data processing in YYYY-MM-DD format

Format"date"

Pin

Profession identifier obtained from "Professions" directory

Format"int64"

Rating

Valid values"APPROVE""DENY""GOOD""MEDIUM""TECH_FAULT""UNDEFINED""VALIDATION_ERROR"

Rating date in YYYY-MM-DD format

Format"date"
object

Registration address (for legal entities Legal address)

object

OGRNIP

Rental income

Format"double"

Resident Yes / No

INN

Role ID

Format"int64"
object[]

Current loans and borrowings

Gender

Format"int64"

Shareholder

Abbreviated name of the organization

SMS history

SNILS

Form of study

Year of graduation

OKPO code (for legal entities)

Name of company

Validity - month

Validity - year

object

Work place information

Valid values"error""ok"
Format"int64"