1 - Identification of the individual/legal entity
comp id = "1"
Request params
*mandatory fields
<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) |
<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) |