1 - Identification of the individual/legal entity


comp id = "1"

Request params

*mandatory fields

<cki> (1) Identification of the individual/legal entity

<cki> (1) Identification of the individual/legal entity

inn

TIN of the credit history subject

[N,10] 10 numeric characters

lname*

Last name

[TEXT,40] variable length text format, up to 40 characters

fname*

First name

[TEXT,40] variable length text format, up to 40 characters

mname*

Middle name

[TEXT,40] variable length text format, up to 40 characters

reqlng*

Search/transfer language (ref. 23)

[N,10] 10 numeric characters

reqlngref*

Part presentation language, value (ref. 23)

[TEXT,250] variable length text format, up to 250 characters

bdate*

Date of birth

[YYYY-MM-DD], YYYY – year (1920–2099), MM – month (01–12), DD – day (01–31)

<ident> (1..*)

vdate*

Date of the information from this part

[YYYY-MM-DD], YYYY – year (1920–2099), MM – month (01–12), DD – day (01–31)

lng*

Part presentation language (ref. 23)

[N,10], numeric format

lngref*

Part presentation language, value (ref. 23)

[TEXT,250] variable length text format, up to 250 characters

inn

TIN of the credit history subject

[N,10] 10 numeric characters

lname*

Last name

[TEXT,40] variable length text format, up to 40 characters

fname*

First name

[TEXT,40] variable length text format, up to 40 characters

mname

Middle name

[TEXT,40] variable length text format, up to 40 characters

bdate*

Date of birth

[YYYY-MM-DD], YYYY – year (1920–2099), MM – month (01–12), DD – day (01–31)

csex*

Sex (code from ref. 1)

[N,10], numeric format

csexref*

Value from the "Sex" reference book (value from ref. 1)

[TEXT,250] variable length text format, up to 250 characters

family

Marital status (code from ref. 2)

[N,10], numeric format

familyref

Value from the "Marital status" reference book (value from ref. 2)

[TEXT,250] variable length text format, up to 250 characters

ceduc

Education (code from ref. 3)

[N,10], numeric format

ceducref

Value from the "Education" reference book (value from ref. 3)

[TEXT,250] variable length text format, up to 250 characters

cgrag

Citizenship (code from ref. 4)

[TEXT,250] variable length text format, up to 250 characters

cgragref

Value from the "Citizenship" reference book (value from ref. 4)

[TEXT,250] variable length text format, up to 250 characters

spd

Presence of the business entity’s registration (code from ref. 5)

[N,10], numeric format

spdref

Value from the "Presence of the business entity’s registration" reference book (value from ref. 5)

[TEXT,250] variable length text format, up to 250 characters

sstate

Social status (code from ref. 6)

[N,10], numeric format

stateref

Value from the "Social status" reference book (value from ref. 6)

[TEXT,250] variable length text format, up to 250 characters

cchild

Number of children

[N,10], numeric format

donor

Source of information (code from ref. 54)

[TEXT,3], text format, 3 characters

<work> (0..*) Block of information history of the place of work

vdate*

Date of the information from this part

[YYYY-MM-DD], YYYY – year (1920–2099), MM – month (01–12), DD – day (01–31)

lng*

Part presentation language (ref. 23)

[N,10], numeric format

lngref*

Part presentation language, value (ref. 23)

[TEXT,250] variable length text format, up to 250 characters

cdolgn

Official position (code from ref. 8)

[N,10], numeric format

cdolgnref

Value from the "Official position" reference book (value from ref. 8)

[TEXT,250] variable length text format, up to 250 characters

wokpo*

EDRPOU of the employer

[N,8] 8 numeric characters

wname*

Name of the employer in the base language

[TEXT,250] variable length text format, up to 250 characters

wstag

Length of service, years completed

[N,10], numeric format

wdohod

Client’s monthly income

[N,15,2], numeric format with a floating point, 2 digits after the point

wdonor

Source of information (code from ref. 54)

[TEXT,3] text format, 3 characters

<urident> (1..*) Legal entity identification history block

okpo

EDRPOU of the legal entity

[N,8] 8 numeric characters

vdate*

Date of the information from this part

[YYYY-MM-DD], YYYY – year (1920–2099), MM – month (01–12), DD – day (01–31)

lng*

Part presentation language (ref. 23)

[N,10], numeric format

lngref*

Part presentation language, value (ref. 23)

[TEXT,250] variable length text format, up to 250 characters

urname*

Name of the legal entity

[TEXT,250] variable length text format, up to 250 characters

urfrms

Ownership type (code from ref. 38)

[N,10], numeric format

urfrmsref

Ownership type (value from ref. 38)

[TEXT,250] variable length text format, up to 250 characters

ureconom

Industrial sector (2010 Classifier of economic activities section) (code from ref. 36)

[TEXT,100] variable length text format, up to 100 characters

ureconomref

Industrial sector (2010 Classifier of economic activities section) (value from ref. 36)

[TEXT,250] variable length text format, up to 250 characters

urvide

Activity type (2010 Classifier of economic activities) (code from ref. 37)

[TEXT,100] variable length text format, up to 100 characters

urvideref

Activity type (2010 Classifier of economic activities) (value from ref. 37)

[TEXT,250] variable length text format, up to 250 characters

urdatreg

Date of registration in EDR (Unified State Register)

[YYYY-MM-DD], YYYY – year (1920–2099), MM – month (01–12), DD – day (01–31

urdatregnal

Date of registration in tax agency

[YYYY-MM-DD], YYYY – year (1920–2099), MM – month (01–12), DD – day (01–31

donor*

Source of information (code from ref. 54)

[TEXT,3], text format, 3 characters

<linked> (1..*) Block of related persons for legal entities (Director, accountant ...)

okpo2

TIN/EDRPOU code of the associated person

[N,10] 10 numeric characters

okpo2_name*

Full name/Name of the associated person

[TEXT,250] variable length text format, up to 250 characters

linkrole*

Association type (code from ref. 39)

[N,10], numeric format

linkroleref*

Association type (value from ref. 39)

[TEXT,250] variable length text format, up to 250 characters

rdate*

Association actualization date

[YYYY-MM-DD], YYYY – year (1920–2099), MM – month (01–12), DD – day (01–31)

ldonor*

Source of information (code from ref. 54)

[TEXT,3], text format, 3 characters

<doc> (1..*) Document information history block

vdate*

Date of the information from this part

[YYYY-MM-DD], YYYY – year (1920–2099), MM – month (01–12), DD – day (01–31)

lng*

Part presentation language (ref. 23)

[N,10], numeric format

lngref*

Part presentation language, value (ref. 23)

[TEXT,250] variable length text format, up to 250 characters

dtype*

Document type (code from ref. 7)

[N,10], numeric format

dtyperef*

Value from the "Document type" reference book (value from ref. 7)

[TEXT,250] variable length text format, up to 250 characters

dser*

Document series

[TEXT,10] variable length text format, up to 10 characters

dnom*

Document number

[TEXT,9] variable length text format, up to 9 characters

dterm

Expiration date (mandatory for ID cards)

[YYYY-MM-DD], YYYY – year (1920–2099), MM – month (01–12), DD – day (01–31)

dwho*

Issuer

[TEXT,200] variable length text format, up to 200 characters

dwdt*

Document issue date

[YYYY-MM-DD], YYYY – year (1920–2099), MM – month (01–12), DD – day (01–31)

eddr_number

Unique record number in the Unified State Demographic Register

[TEXT,~] variable length text format

ddonor

Source of information (code from ref. 54)

[TEXT,3] text format, 3 characters

<addr> (1..*) Address information history block

vdate*

Date of the information from this part

[YYYY-MM-DD], YYYY – year (1920–2099), MM – month (01–12), DD – day (01–31)

lng*

Part presentation language (ref. 23)

[N,10], numeric format

lngref*

Part presentation language, value (ref. 23)

[TEXT,250] variable length text format, up to 250 characters

adtype*

Address type (code from ref. 9)

[N,10], numeric format

adtyperef*

Value from the "Address type" reference book (value from ref. 9)

[TEXT,250] variable length text format, up to 250 characters

adcountry*

Country

[TEXT,40] variable length text format, up to 40 characters

adindex

Postal code

[TEXT,20] variable length text format, up to 20 characters

adstate

Region

[TEXT,40] variable length text format, up to 40 characters

adarea

District

[TEXT,40] variable length text format, up to 40 characters

adcity*

Locality

[TEXT,40] variable length text format, up to 40 characters

adcitytype

Locality type (code from ref. 22)

[N,10], numeric format

adcitytyperef

Value from the "Locality type" reference book (value from ref. 22)

[TEXT,250] variable length text format, up to 250 characters

adstreet*

Street

[TEXT,100] variable length text format, up to 100 characters

adhome*

House

[TEXT,40] variable length text format, up to 40 characters

adcorp

Block

[TEXT,40] variable length text format, up to 40 characters

adflat

Flat

[TEXT,40] variable length text format, up to 40 characters

addrdirt

Address in one row (will not be used in subsequent API versions, the field is deemed invalid starting from 13.11.2019)

[TEXT,1000] variable length text format, up to 1000 characters

addonor

Source of information (code from ref. 54)

[TEXT,3] text format, 3 characters

</cki>

<identdocmvds> (1) Block for converting documents for validity

found

Found? (Code from ref. 27)

[N,10] 10 numeric characters

foundref

Аlue from the "Found?" reference book (Value from ref. 27)

[TEXT,40] variable length text format, up to 40 characters

foundtitle

Search result description

[TEXT,250] variable length text format, up to 250 characters

pser

Passport series

[TEXT, 10] text format of variable length, up to 10 characters

pnom

Passport number or ID card number

[TEXT, 50] text format of variable length, up to 50 characters

dtype

Document type (ref. 7). If dtype is not filled, then by default 1 (backward compatibility)

[N, 10], numerical format

dtyperef

Document type (Value from ref. 7)

[TEXT, 50] text format of variable length, up to 50 characters

<foundsource>(1..*) The result for each source of verification

name

Data source for verification (Code from ref. 63)

[TEXT,10] variable length text format, up to 10 characters

found

Numeric indication of the presence of an invalid passport (Code from ref. 27)

[N,10] 10 numeric characters

foundref

Text indication of the presence of an invalid passport (Value from ref. 27)

[TEXT,40] variable length text format, up to 40 characters

sourcedate

The date of updating the information in the database or receiving a response from the API of the original source

[YYYY-MM-DD], YYYY – year (1920–2099), MM – month (01–12), DD – day (01–31)