10 - Credit report of an individual


Information on past and current loans of individuals and the history of their repayment.


Http Method

POST

Request JSON
( ** the parameters are transferred optionally if there is a credit history for this client from your organization)

{

"doc": {

"ubki": {

"req_envelope": {

"req_xml": {

"request": {

"i": {

"ident": {

"okpo": "Tax/Taxpayer Identification Number (INN-RNUKPN, for individuals)",

"lname": "**Last name",

"fname": "**First name",

"mname": "**Middle name",

"bdate": "**Date of birth"

},

"spd": {

"inn": "Tax/Taxpayer Identification Number (INN-RNUKPN, for legal entities)"

},

"contacts": {

"cont": {

"ctype": "**Contact type (code from ref.10)",

"cval": "**Contact value"

}

},

"docs": {

"doc": {

"dtype": "**Document type (code from ref.7)",

"dser": "**Document series",

"dnom": "**Document number"

}

},

"mvd": {

"dtype": "Document type (code from ref.7)",

"pser": "Series of the required passport",

"pnom": "Number of required passport or ID-card number",

"plname": "**Surname of the required passport",

"pfname": "**Name of the required passport",

"pmname": "**Patronymic of the required passport",

"pbdate": "**Date of birth of the required passport"

},

"reqlng": "Search criteria language (Code from ref.23)"

},

"version": "1.0",

"reqtype": "Template code (Code from the ref.49): 'Credit report of an individual' - 10",

"reqreason": "Purpose of the request (Code from the ref.24)"

},

"descr": "Request object"

},

"descr": "Request envelope"

},

"sessid": "Session key (we receive it from the API authorization)"

}

}

}

Response JSON

{

"ubkidata": {

"tech": {

"trace": {

"step": {

"name": "Step name",

"stm": "Step start stamp date",

"ftm": "Step finish stamp date"

}

},

"error": {

"errtype": "Error code (code from ref.0)",

"errtext": "Error text (value from ref.0)"

},

"reqinfo": {

"reqid": "Outgoing request ID generated by UBKI"

},

"billing": {

"balance": {

"value": "Total assets",

"date": "Date",

"time": "Time"

}

}

},

"comp": [

{

"cki": {

"ident": {

"donor": "Source of information (code from ref. 54)",

"vdate": "Date of the information from this part",

"lng": "Part presentation language (code from ref.23)",

"lngref": "Part presentation language (value from ref.23)",

"inn": "TIN of the credit history subject",

"lname": "Last name",

"fname": "First name",

"mname": "Middle name",

"bdate": "Date of birth",

"csex": "Sex (code from ref.1)",

"csexref": "Sex (value from ref.1)",

"family": "Marital status (code from ref.2)",

"familyref": "Marital status (value from ref.2)",

"ceduc": "Education (code from ref.3)",

"ceducref": "Education (value from ref.3)",

"cgrag": "Citizenship (code from ref.4)",

"cgragref": "Citizenship (value from ref.4)",

"spd": "Presence of the business entity’s registration (code from ref.5)",

"spdref": "Presence of the business entity’s registration (value from ref.5)",

"sstate": "Social status (code from ref.6)",

"sstateref": "Social status (value from ref.6)",

"cchild": "Number of children"

},

"work": {

"wdonor": "Source of information (code from ref. 54)",

"vdate": "Date of the information from this part",

"lng": "Part presentation language (code from ref.23)",

"lngref": "Part presentation language (value from ref.23)",

"cdolgn": "Official position (code from ref.8)",

"cdolgnref": "Official position (value from ref.8)",

"wokpo": "EDRPOU of the employer",

"wname": "Name of the employer in the base language",

"wstag": "Length of service, years completed",

"wdohod": "Client’s monthly income"

},

"doc": {

"ddonor": "Source of information (code from ref. 54)",

"vdate": "Date of the information from this part",

"lng": "Part presentation language (code from ref.23)",

"lngref": "Part presentation language (value from ref.23)",

"dtype": "Document type (code from ref.7)",

"dtyperef": "Document type (value from ref.7)",

"dser": "Document series",

"dnom": "Document number",

"dterm": "Expiration date",

"dwho": "Document issuer",

"dwdt": "Document issue date",

"eddr_number": "Unique record number in the Unified State Demographic Register"

},

"addr": {

"addonor": "Source of information (code from ref. 54)",

"vdate": "Date of the information from this part",

"lng": "Part presentation language (code from ref.23)",

"lngref": "Part presentation language (value from ref.23)",

"adtype": "Address type (code from ref.9)",

"adtyperef": "Address type (value from ref.9)",

"adcountry": "Country (two-character code from ISO 3166 reference book)",

"adindex": "Postal code",

"adstate": "Region",

"adarea": "District",

"adcity": "Locality",

"adcitytype": "Locality type (code from ref.22)",

"adcitytyperef": "Locality type (value from ref.22)",

"adstreet": "Street",

"adhome": "House",

"adcorp": "Block",

"adflat": "Flat",

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

},

"inn": "TIN of the credit history subject/EDRPOU of the legal entity",

"lname": "Last name/Name of the legal entity",

"fname": "First name",

"mname": "Middle name",

"reqlng": "Search language (while searching)/Identification language (during transfer) (code from ref.23)",

"reqlngref": "Search language (while searching)/Identification language (during transfer) (value from ref.23)",

"bdate": "Date of birth"

},

"identdocmvds": {

"identdocmvd": {

"foundsource": {

"name": "Data source for verification (Code from ref.63)",

"found": "0/1 - digital indication of the presence of an invalid passport (Code from ref.27)",

"foundref": "Text indication of the presence of an invalid passport (Value from ref.27)",

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

},

"found": "Found? (Code from ref.27)",

"foundref": "Found? (Value from ref.27)",

"foundtitle": "Search result description",

"pser": "Series of the required passport",

"pnom": "Number of required passport or ID-card number",

"dtype": "Document type (Code from ref.7)",

"dtyperef": "Document type (Meaning from ref.7)"

}

},

"id": "1",

"descr": "Names of components"

},

{

"crdeal": {

"deallife": {

"dlref": "Transaction identifier",

"dlmonth": "Data period (month)",

"dlyear": "Data period (year)",

"dlds": "Date of the transaction beginning",

"dldpf": "Date of the transaction ending by the agreement",

"dldff": "Actual date of the transaction ending",

"dlflstat": "Transaction Status at the current period (Code from ref.16)",

"dlflstatref": "Transaction status at the current period (Meaning from ref.16)",

"dlamtlim": "Current transaction limit (for revolving transactions, credit cards)",

"dlamtpaym": "The amount of the obligatory payment in the current period",

"dlamtcur": "The sum of the current debt",

"dlamtexp": "The sum of the current outstanding debt",

"dldayexp": "Current number of days in arrears",

"dlflpay": "The sign of payment execution in the current period (the code from ref.13)",

"dlflpayref": "The sign of payment execution in the current period (Meaning from ref.13)",

"dlflbrk": "The sign of the existence of an outstanding payment in the current period (the code from ref.13)",

"dlflbrkref": "The sign of the existence of an outstanding payment in the current period (Meaning from ref.13)",

"dlfluse": "Characteristics of a credit tranche in the current period (code from ref.13)",

"dlfluseref": "Characteristics of a credit tranche in the current period (Meaning from ref.13)",

"dldateclc": "Calculation Date"

},

"dlref": "Transaction identifier",

"lng": "Block representation language (Code from ref.23)",

"lngref": "Block representation language (Meaning from ref.23)",

"inn": "INN SKI / EGRPOU of the legal entity",

"lname": "Surname/Name of the legal entity",

"fname": "Name",

"mname": "Father’s name",

"bdate": "Date of Birth",

"dlcelcred": "Transaction type (Code from ref.17)",

"dlcelcredref": "Transaction type (Meaning from ref.17)",

"dlvidobes": "Type of collateral (Code from ref.15)",

"dlvidobesref": "Type of collateral (Meaning from ref.15)",

"dlporpog": "Repayment procedure (Code from ref.18)",

"dlporpogref": "Repayment procedure (Meaning from ref.18)",

"dlcurr": "Transaction currency (Code from ref.12)",

"dlcurrref": "Transaction currency (Meaning from ref.12)",

"dlamt": "Transaction sum (initial)",

"dldonor": "Information donor (code from ref.54)",

"dlrolesub": "Role of the subject (Code from ref.14)",

"dlrolesubref": "Role of the subject (Meaning from ref.14)",

"dlamtobes": "Cost of collateral in the base currency"

},

"id": "2",

"descr": "Components name"

},

{

"penaltiesCount": {

"totalCount": "The total number of enforcement proceedings for all time",

"activeCount": "Number of active enforcement proceedings"

},

"susd": {

"changes": {

"voteid": "Enforcement Number",

"inn": "TIN of the debtor",

"votedate": "Enforcement start date",

"votesudname": "Executor",

"vdate": "Record Date",

"credname": "Name of creditor",

"credokpo": "Creditor`s code",

"vpstate": "Status of proceedings"

},

"votesudname": "Executor",

"votetype": "Enforcement type",

"votedate": "Enforcement start date",

"inn": "TIN of the debtor",

"voteid": "Enforcement Number",

"votedonor": "Source of information",

"votesudphone": "Executor’s phone",

"votesudemail": "Executor’s email",

"vdate": "Record update date",

"credname": "Creditor name",

"credokpo": "Creditor`s code",

"vpstate": "Status of proceedings"

},

"id": "3",

"descr": "Information on the enforcement proceedings of SKI"

},

{

"credres": {

"redate": "Date of decision",

"retime": "Time of decision",

"inn": "INN",

"reqid": "Request identifier in the Bureau",

"result": "Report result (Code from ref.19)",

"resultref": "Report result (Meaning from ref.19)",

"reqreason": "Reason for the request in to the bureau (Code from ref.24)",

"reqreasonref": "Reason for the request in to the bureau (Meaning from ref.24)",

"org": "Initiating agency (code from ref.54)",

"typereport": "The type of report provided (Code from ref.71)",

"typereportref": "The type of report provided (Meaning from ref.71)"

},

"reestrtime": {

"hr": "Number of requests per hour",

"da": "Number of requests per day",

"wk": "Number of requests per week",

"mn": "Number of requests per month",

"qw": "Number of requests per quarter",

"ye": "Number of requests per year",

"yu": "Number of requests per over a year"

},

"id": "4",

"descr": "Components name"

},

{

"mvd": {

"foundsource": {

"name": "Data source for verification (Code from ref. 63)",

"found": "0/1 - digital indication of the presence of an invalid passport (Code from ref.27)",

"foundref": "Text indication of the presence of an invalid passport (Value from ref.27)",

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

},

"found": "Is it found? (The code from ref.27)",

"foundref": "Is it found? (Meaning from ref.27)",

"foundtitle": "Description of the search result",

"pser": "Series of the required passport",

"pnom": "Number of the required passport or number of ID-card",

"plname": "Surname of the required passport",

"pfname": "Name of the required passport",

"pmname": "Father’s name of the required passport",

"pbdate": "Date of birth of the required passport",

"status": "Reason for cancellation (Only for data from DATA.GOV.UA)",

"stdate": "Cancellation Date (Only for data from DATA.GOV.UA)"

},

"id": "5",

"descr": "Components name"

},

{

"moncredres": {

"org": "Initiating organization (code from ref.54)",

"resultref": "Monitoring result (value from ref.19)",

"result": "Monitoring result (Code from ref.19)",

"monid": "Unique Monitoring Identifier",

"inn": "TIN",

"startdate": "Monitoring start date",

"enddate": "Date of last monitoring "

},

"id": "6",

"descr": "Components name"

},

{

"cont": {

"inn": "TIN of the credit history subject/EDRPOU of the legal entity",

"cdonor": "Source of information",

"vdate": "Date of the information from this part",

"ctype": "Contact type (code from ref.10)",

"ctyperef": "Contact type (value from ref.10)",

"cval": "Contact value"

},

"id": "10",

"descr": "Names of components"

},

{

"utilitiesdebt": {

"utldebt": {

"debtDate": "Date of calculation of arrears for payment of communal services",

"totalDebt": "Current arrears for the payment of utility services, taking into account overdue arrears on bills for the previous period and the last bill issued",

"expDebt": "Overdue arrears for the payment of utility services on bills for the previous period, without the last issued bill"

},

"inn": "TIN code of the utility payer",

"branch": "Center of operational activity or utility service region",

"account": "Personal account",

"accountDate": "The date of opening a personal account",

"utltypetype": "Type of utility service (code)",

"utltypetyperef": "Type of utility service (name)",

"isDebtState": "The fact of open overdue debt for the payment of communal services",

"dbDate": "Data update date in the Bureau",

"debtMonthNumber":"Number of months of debt for utility services (0-36, 99 - more than 3 years or an indefinite term)"

},

"id": "11",

"descr": "Debt for communal services"

},

{

"spd": {

"found": "Status in EGR (Code from ref.27)",

"inn": "INN of a business entity",

"name": "Name of business entity",

"state": "The current status of the subject",

"statetxt": "Additional subject status comment",

"regdate": "Registration Date of SPD",

"kindcode": "Code of the main type of activity on KVED",

"kindname": "Name of the main type of economic activity",

"termnumber": "Number of the record of state registration of the termination of business activities",

"termcause": "The basis for making a record of the state registration of the termination of business activities",

"termdate": "Record date of state registration of termination of business activities",

"tel": "List of phones SPD",

"fax": "SPD fax number",

"email": "SPD email address",

"adress": "Residential address",

"regrecordnumber": "Record number in the Unified State Register",

"vdate": "Date of information update"

},

"registration": {

"name": "Name of registration authority",

"code": "EDRPOU registration authority code",

"type": "Registration Authority Type",

"description": "Description",

"startdate": "Date of registration with the authority",

"startnum": "Registration number with the authority",

"enddate": "Date of the deregistration entry in the authority",

"endnum": "Deregistration record number"

},

"id": "14",

"descr": "Components name"

},

{

"wantedmvs": {

"found": "0-not found, 1-found",

"foundref": "not found/found",

"bdate": "Date of Birth",

"lng": "Block representation language (Code from ref.23)",

"lngref": "Block representation language (Meaning from ref.23)",

"lname": "Surname",

"fname": "Name",

"mname": "Father’s name",

"url": "A reference to the Ministry of Internal Affairs form",

"category": "Category",

"articlecrim": "Article of accusation",

"restraint": "Preventive measure"

},

"id": "17",

"descr": "Components name"

},

{

"pret": {

"pretension": {

"inn": "INN (for natural persons)/OKPO (for legal entities)",

"crdeal": "Transaction identifier (reference)",

"source": "Disputing type (Code from ref.48)",

"sourceref": "Disputing type (Value from ref.48)",

"claim" : "Subject of dispute (Code from ref. 69)",

                         "claimref": "Subject of dispute (Value from ref. 69)",

"vdate": "Date of the request creation"

},

"commentcki": {

"comment": "Commentary of the subject of credit history",

"vdate": "Date of a comment creation"

},

"plost": {

"pser": "Passport series claimed by the client as lost (theft)",

"pnom": "Passport number declared by the client as lost (theft)",

"crdate": "ДDate of creation of an application for the loss/theft of a client's passport in UBCH",

"ldate": "The date of loss / theft of the client's passport indicated in the application in UBCH"

},

"changedeal": {

"crdeal": "Transaction identifier (reference)",

"changecode": "Code for the reason of correction/deletion of data (Code from ref.62)",

"changeref": "Text of the reason for correcting/deleting data (Value from ref.62)",

"vdate": "Date of data correction/deletion"

},

"freezedate": "FREEZE option connection date",

"nonewdealcomment": "Comment",

"nonewdeal": "Sign of reluctance to draw up new loan products, connection status of the FREEZE option: 0 - not enabled, 1 - enabled",

"nonewdealref": "The value of the sign of unwillingness to draw up new credit products, the connection status of the FREEZE option is 0-no (the option is not connected), 1-yes (the option is connected)",

"inn": "INN (for natural persons)/OKPO (for legal entities)"

},

"fcert": {

"inn": "TIN",

"cert": "Availability of a certificate from the UBCH (code from ref. 56) - 0 - no (no registered certificate), 1 - yes (registered certificate) ",

"certref": "Availability of a certificate from the UBCH (value from ref. 56)",

"certid": "Certificate number",

"certurl": "Link to the certificate"

},

"maybegone": {

"inn": "TIN",

"vdate": "Application creation date",

"dldonor": "Information provider (code from ref. 54)"

},

"id": "18",

"descr": "Components name"

},

{

"sanctions": {

"sanctionsData": {

"countryCode": "Country code",

"country": "The name of the country",

"sanction": "Presence of sanctions imposed by the country (Code from ref. 68)",

"date": "Date of entry into the list",

"url": "Link to the document – confirmation"

},

"found": "Availability of information (Code from ref. 27)",

"foundRef": "Text interpretation of available information (Code from ref. 27)",

"subName": "Subject’s name",

"bDate": "Subject’s date of birth",

"position": "Position",

"reason": "Grounds for imposing sanctions",

"typeSearch": "Search type (Code from ref. 67)",

"typeSearchText": "Text interpretation of the type of search (Code from ref. 67)"

},

"id": "40",

"descr": "Information from sanctions lists"

},

{

"pep": {

"found": "0 – not located, 1 – located ",

"foundref": "not located/located",

"subname": "Subject’s name",

"bdate": "Subject’s date of birth",

"category": "Category of the politically exposed person",

"lastpost": "Last position",

"dateofrelease": "Date of leaving of the last position",

"isur": "Indication of legal entity",

"state": "Status of legal entity",

"url": "Link to the document – confirmation"

},

"id": "41",

"descr": "Information from the Public Register of Politically Exposed Persons of Ukraine"

},

{

"contact": {

"cval": "Contact value",

"ctype": "Contact type (code from ref.10)",

"ctyperef": "Contact type in text format (ref.10)",

"cstate": "Contact’s status (code from ref.57)",

"cstateref": "Contact’s status (text value from ref.57)",

"vdatestart": "First actualization date",

"vdate": "Last actualization date"

},

"id": "46",

"descr": "Names of components"

},

{

"bankruptcyinfo": {

"bankruptcy": {

"subname": "Subject’s name",

"subcode": "TIN/EDRPOU",

"eventtype": "Event type",

"eventclaimer": "Initiator of the event",

"eventcourtcase": "Case number",

"eventdate": "Date of event"

},

"found": "Availability of information about bankruptcy, numerical designation 0-1",

"foundref": " Availability of information about bankruptcy, textual meaning 0-not found / 1-found"

},

"id": "54",

"descr": "Bankruptcy information"

},

{

"fcert": {

"inn": "TIN",

"cert": "Availability of a certificate from the UBCH (code from ref. 56) - 0 - no (no registered certificate), 1 - yes (registered certificate) ",

"certref": "Availability of a certificate from the UBCH (value from ref. 56)",

"certid": "Certificate number",

"certurl": "Link to the certificate"

},

"maybegone": {

"inn": "TIN",

"vdate": "Application creation date",

"dldonor": "Information provider (code from54 - Reference ''Information source/donor''ref. 54)"

},

"id": "68",

"descr": "Additional information about CHS"

},

{

"person": {

"bdate": "Date of birth",

"lngref": "Search/transfer language (ref. 23)",

"lng": "Part presentation language, value (ref. 23)",

"mname": "Middle name",

"fname": "First name",

"lname": "Last name",

"inn ": "TIN of the credit history subject"

},

"id": "72",

"descr": "Search by full name + inn if more than 1 person is found (The presence of the component is determined by searching for more than 1 person in the case of searching by full name + inn)"

},

{

"ludomans":{

"found": "Numerical indication of whether a person is found in the register - 0/1",

"foundref": "Textual definition of whether a person is found in the register: Not found (0)/Found (1)",

"information": {

"searchType": "Search type - 0/1/2/3",

"searchTypeRef": "Text definition of search type: No matches found (0)/Found by TIN (1)/Found by name and date of birth (2)/Found by last name, first name and date of birth (3)",

"lastName": "Last name",

"firstName": "Name",

"middleName": "Middle name",

"dateOfBirth": "Date of birth",

"inn": "TIN",

"documentSeries": "Document series",

"documentNumber": "Document number",

"documentIssuedDate": "Document issue date",

"documentIssuedBy": "Issuer",

"documentOtherData": "Other information about the document",

"passport": "Passport",

"gender": "Sex",

"address": "Address",

"communication": "Contacts",

"stateCode": "Country code",

"rDateFrom": "Period start date",

"rDateTill": "Period end date",

"reason": "Reason"

}

},

"id": "76",

"descr": "Information from the Register of persons who have restricted access to gambling establishments and/or participation in gambling (using credit funds)"

}

}

}

Request XML
( ** the parameters are transferred optionally if there is a credit history for this client from your organization)

<?xml version="1.0" encoding="utf-8"?>

<doc>

<ubki sessid="Session key (we receive it from the API authorization)">

<req_envelope descr="Request envelope">

<req_xml descr="Request object">

<!-- Request Parameters -->

<request version="1.0" reqtype="Template code (Code from the ref.49): 'Credit report of an individual' - 10" reqreason="Purpose of the request (Code from the ref.24)">

<!-- Parameters, which describe the search criteria-->

<i reqlng="Search criteria language (Code from ref.23)">

<!-- Identification parameters of the subject-->

<ident okpo="Tax/Taxpayer Identification Number (INN-RNUKPN, for individuals)"

lname="**Last name"

fname="**First name"

mname="**Middle name"

bdate="**Date of birth">

</ident>

<spd inn="Tax/Taxpayer Identification Number (INN-RNUKPN, for legal entities)" />

<contacts>

<cont ctype="**Contact type (code from ref.10)"

cval="**Contact value" />

</contacts>

<docs>

<doc dtype="**Document type (code from ref.7)"

dser="**Document series"

dnom="**Document number" />

</docs>

<!-- For the requests to the search for canceled documents -->

<mvd dtype="Document type (code from ref.7)"

pser="Series of the required passport"

pnom="Number of required passport or ID-card number"

plname="**Surname of the required passport"

pfname="**Name of the required passport"

pmname="**Patronymic of the required passport"

pbdate="**Date of birth of the required passport">

</mvd>

</i>

</request>

</req_xml>

</req_envelope>

</ubki>

</doc>

Response XML

<?xml version="1.0" encoding="utf-8"?>

<ubkidata>

<!-- System information part -->

<tech>

<trace>

<step name="Step name" stm="Step start stamp date" ftm="Step finish stamp date">

<!-- The trace part contains timing metrics of components generation steps -->

</step>

</trace>

<error errtype="Error code (code from ref.0)" errtext="Error text (value from ref.0)">

</error>

<reqinfo reqid="Outgoing request ID generated by UBKI">

</reqinfo>

<!-- Information about the current status of the prepaid account part-->

<billing>

<balance value="Total assets" date="Date" time="Time" />

</billing>

</tech>

<!-- Identification part -->

<comp id="1" descr="Names of components">

<cki inn="TIN of the credit history subject/EDRPOU of the legal entity"

lname="Last name/Name of the legal entity"

fname="First name"

mname="Middle name"

reqlng="Search language (while searching)/Identification language (during transfer) (code from ref.23)"

reqlngref="Search language (while searching)/Identification language (during transfer) (value from ref.23)"

bdate="Date of birth">

<ident donor="Source of information (code from ref. 54)"

vdate="Date of the information from this part"

lng="Part presentation language (code from ref.23)"

lngref="Part presentation language (value from ref.23)"

inn="TIN of the credit history subject"

lname="Last name"

fname="First name"

mname="Middle name"

bdate="Date of birth"

csex="Sex (code from ref.1)"

csexref="Sex (value from ref.1)"

family="Marital status (code from ref.2)"

familyref="Marital status (value from ref.2)"

ceduc="Education (code from ref.3)"

ceducref="Education (value from ref.3)"

cgrag="Citizenship (code from ref.4)"

cgragref="Citizenship (value from ref.4)"

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

spdref="Presence of the business entity’s registration (value from ref.5)"

sstate="Social status (code from ref.6)"

sstateref="Social status (value from ref.6)"

cchild="Number of children">

<!--This part can and must contain 1..* items-->

</ident>

<!-- History of the Information about Employer part -->

<work wdonor="Source of information (code from ref.54)"

vdate="Date of the information from this part"

lng="Part presentation language (code from ref.23)"

lngref="Part presentation language (value from ref.23)"

cdolgn="Official position (code from ref.8)"

cdolgnref="Official position (value from ref.8)"

wokpo="EDRPOU of the employer"

wname="Name of the employer in the base language"

wstag="Length of service, years completed"

wdohod="Client’s monthly income">

<!--This part can contain 0..*-->

</work>

<!-- History of the Information about Documents part -->

<doc ddonor="Source of information (code from ref.54)"

vdate="Date of the information from this part"

lng="Part presentation language (code from ref.23)"

lngref="Part presentation language (value from ref.23)"

dtype="Document type (code from ref.7)"

dtyperef="Document type (value from ref.7)"

dser="Document series"

dnom="Document number"

dterm="Expiration date"

dwho="Document issuer"

dwdt="Document issue date"

eddr_number="Unique record number in the Unified State Demographic Register">

<!--This part must contain 1..* units and at least one document-->

</doc>

<!-- History of the Information about Addresses part -->

<addr addonor="Source of information (code from ref.54)"

vdate="Date of the information from this part"

lng="Part presentation language (code from ref.23)"

lngref="Part presentation language (value from ref.23)"

adtype="Address type (code from ref.9)"

adtyperef="Address type (value from ref.9)"

adcountry="Country (two-character code from ISO 3166 reference book)"

adindex="Postal code"

adstate="Region"

adarea="District"

adcity="Locality"

adcitytype="Locality type (code from ref.22)"

adcitytyperef="Locality type (value from ref.22)"

adstreet="Street"

adhome="House"

adcorp="Block"

adflat="Flat"

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

<!--This part must contain 1..* units and at least one address-->

</addr>

</cki>

<!-- Block for converting documents for validity -->

<identdocmvds>

<identdocmvd found="Found? (Code from ref.27)"

foundref="Found? (Value from ref.27)"

foundtitle="Search result description"

pser="Series of the required passport"

pnom="Number of required passport or ID-card number"

dtype="Document type (Code from ref.7)"

dtyperef="Document type (Meaning from ref.7)">

<foundsource name="Data source for verification (Code from ref.63)"

found="0/1 - digital indication of the presence of an invalid passport (Code from ref.27)"

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

sourcedate="The date of updating the information in the database or receiving a response from the API of the original source" />

<!--This part must contain 1..* units and at least one document -->

</identdocmvd>

</identdocmvds>

</comp>

<!-- Block of information on credit transactions -->

<comp id="2" descr="Components name">

<crdeal dlref="Transaction identifier"

lng="Block representation language (Code from ref.23)"

lngref="Block representation language (Meaning from ref.23)"

inn="INN SKI / EGRPOU of the legal entity"

lname="Surname/Name of the legal entity"

fname="Name" mname="Father’s name"

bdate="Date of Birth"

dlcelcred="Transaction type (Code from ref.17)"

dlcelcredref="Transaction type (Meaning from ref.17)"

dlvidobes="Type of collateral (Code from ref.15)"

dlvidobesref="Type of collateral (Meaning from ref.15)"

dlporpog="Repayment procedure (Code from ref.18)"

dlporpogref="Repayment procedure (Meaning from ref.18)"

dlcurr="Transaction currency (Code from ref.12)"

dlcurrref="Transaction currency (Meaning from ref.12)"

dlamt="Transaction sum (initial)"

dldonor="Information donor (code from ref.54)"

dlrolesub="Role of the subject (Code from ref.14)"

dlrolesubref="Role of the subject (Meaning from ref.14)"

dlamtobes="Cost of collateral in the base currency">

<!-- Block of variable values of a credit history -->

<deallife dlref="Transaction identifier"

dlmonth="Data period (month)"

dlyear="Data period (year)"

dlds="Date of the transaction beginning"

dldpf="Date of the transaction ending by the agreement"

dldff="Actual date of the transaction ending"

dlflstat="Transaction Status at the current period (Code from ref.16)"

dlflstatref="Transaction status at the current period (Meaning from ref.16)"

dlamtlim="Current transaction limit (for revolving transactions, credit cards)"

dlamtpaym="The amount of the obligatory payment in the current period"

dlamtcur="The sum of the current debt"

dlamtexp="The sum of the current outstanding debt"

dldayexp="Current number of days in arrears"

dlflpay="The sign of payment execution in the current period (the code from ref.13)"

dlflpayref="The sign of payment execution in the current period (Meaning from ref.13)"

dlflbrk="The sign of the existence of an outstanding payment in the current period (the code from ref.13)"

dlflbrkref="The sign of the existence of an outstanding payment in the current period (Meaning from ref.13)"

dlfluse="Characteristics of a credit tranche in the current period (code from ref.13)"

dlfluseref="Characteristics of a credit tranche in the current period (Meaning from ref.13)"

dldateclc="Calculation Date">

<!--This block has to consist of 1 .. * elements-->

</deallife>

</crdeal>

</comp>

<!-- Information block on enforcement proceedings SKI -->

<comp id="3" descr="Information on the enforcement proceedings of SKI">

<penaltiesCount totalCount="The total number of enforcement proceedings for all time"

activeCount="Number of active enforcement proceedings" />

<susd votesudname="Executor"

votetype="Enforcement type"

votedate="Enforcement start date"

inn="TIN of the debtor"

voteid="Enforcement Number"

votedonor="Source of information"

votesudphone="Executor’s phone"

votesudemail="Executor’s email"

vdate="Record update date"

credname="Creditor name"

credokpo="Creditor`s code"

vpstate="Status of proceedings">

<changes voteid="Enforcement Number"

inn="TIN of the debtor"

votedate="Enforcement start date"

votesudname="Executor"

vdate="Record Date"

credname="Name of creditor"

credokpo="Creditor`s code"

vpstate="Status of proceedings" />

<!-- This block should consist of 0 .. * elements -->

</susd>

</comp>

<!-- Block – a register of requests -->

<comp id="4" descr="Components name">

<credres redate="Date of decision"

retime="Time of decision"

inn="INN"

reqid="Request identifier in the Bureau"

result="Report result (Code from ref.19)"

resultref="Report result (Meaning from ref.19)"

reqreason="Reason for the request in to the bureau (Code from ref.24)"

reqreasonref="Reason for the request in to the bureau (Meaning from ref.24)"

org="Initiating agency (code from ref.54)"

typereport="The type of report provided (Code from ref.71)"

typereportref="The type of report provided (Meaning from ref.71)">

<!--This block has to consist of 1 .. * elements -->

</credres>

<reestrtime hr="Number of requests per hour"

da="Number of requests per day"

wk="Number of requests per week"

mn="Number of requests per month"

qw="Number of requests per quarter"

ye="Number of requests per year"

yu="Number of requests per over a year">

<!--This block has to consist of the 1st element-->

</reestrtime>

</comp>

<!-- Search for canceled documents -->

<comp id="5" descr="Components name">

<mvd found="Is it found? (The code from ref.27)"

foundref="Is it found? (Meaning from ref.27)"

foundtitle="Description of the search result"

pser="Series of the required passport"

pnom="Number of the required passport or number of ID-card"

plname="Surname of the required passport"

pfname="Name of the required passport"

pmname="Father’s name of the required passport"

pbdate="Date of birth of the required passport"

status="Reason for cancellation (Only for data from DATA.GOV.UA)"

stdate="Cancellation Date (Only for data from DATA.GOV.UA)">

<foundsource name="Data source for verification (Code from ref. 63)"

found="0/1 - digital indication of the presence of an invalid passport (Code from ref.27)"

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

sourcedate="The date of updating the information in the database or receiving a response from the API of the original source" />

<!--This part must contain 1..* units and at least one document-->

</mvd>

</comp>

<!-- Block – Monitoring -->

<comp id="6" descr="Components name">

<moncredres org="Initiating organization (code from ref.54)"

resultref="Monitoring result (value from ref.19)"

result="Monitoring result (Code from дов.19)"

monid="Unique Monitoring Identifier"

inn="TIN"

startdate="Monitoring start date"

enddate="Date of last monitoring " />

<!-- This part can contain 0..* items -->

</comp>

<!-- Block of the Information History on the contacts -->

<comp id="10" descr="Names of components">

<cont inn="TIN of the credit history subject/EDRPOU of the legal entity"

cdonor="Source of information"

vdate="Date of the information from this part"

ctype="Contact type (code from ref.10)"

ctyperef="Contact type (value from ref.10)"

cval="Contact value">

<!--This part must contain 1..* units and at least one contact-->

</cont>

</comp>

<!-- Block Debt for communal services-->

<comp id="11" descr="Debt for communal services">

<utilitiesdebt inn="TIN code of the utility payer"

branch="Center of operational activity or utility service region"

account="Personal account"

accountDate="The date of opening a personal account"

utltypetype="Type of utility service (code)"

utltypetyperef="Type of utility service (name)"

isDebtState="The fact of open overdue debt for the payment of communal services"

dbDate="Data update date in the Bureau">

<utldebt debtDate="Date of calculation of arrears for payment of communal services"

totalDebt="Current arrears for the payment of utility services, taking into account overdue arrears on bills for the previous period and the last bill issued"

expDebt="Overdue arrears for the payment of utility services on bills for the previous period, without the last issued bill"

debtMonthNumber="Number of months of debt for utility services (0-36, 99 - more than 3 years or an indefinite term)"/>

</utilitiesdebt>

</comp>

<!-- Block SPD -->

<comp id="14" descr="Components name">

<spd found="Status in EGR (Code from ref.27)"

inn="INN of a business entity"

name="Name of business entity"

state="The current status of the subject"

statetxt="Additional subject status comment"

regdate="Registration Date of SPD"

kindcode="Code of the main type of activity on KVED"

kindname="Name of the main type of economic activity"

termnumber="Number of the record of state registration of the termination of business activities"

termcause="The basis for making a record of the state registration of the termination of business activities"

termdate="Record date of state registration of termination of business activities"

tel="List of phones SPD"

fax="SPD fax number"

email="SPD email address"

adress="Residential address"

regrecordnumber="Record number in the Unified State Register"

vdate="Date of information update" />

<registration name="Name of registration authority"

code="EDRPOU registration authority code"

type="Registration Authority Type"

description="Description"

startdate="Date of registration with the authority"

startnum="Registration number with the authority"

enddate="Date of the deregistration entry in the authority"

endnum="Deregistration record number" />

</comp>

<!-- Block - Search for wanted persons in the Ministry of Internal Affairs database -->

<comp id="17" descr="Components name">

<wantedmvs found="0-not found, 1-found"

foundref="not found/found"

bdate="Date of Birth"

lng="Block representation language (Code from ref.23)"

lngref="Block representation language (Meaning from ref.23)"

lname="Surname"

fname="Name"

mname="Father’s name"

url="A reference to the Ministry of Internal Affairs form"

category="Category"

articlecrim="Article of accusation"

restraint="Preventive measure" />

</comp>

<!-- Alert -->

<comp id="18" descr="Components name">

<pret nonewdeal="Sign of reluctance to draw up new loan products, connection status of the FREEZE option: 0 - not enabled, 1 - enabled"

nonewdealref="The value of the sign of unwillingness to draw up new credit products, the connection status of the FREEZE option is 0-no (the option is not connected), 1-yes (the option is connected)"

freezedate="FREEZE option connection date"

nonewdealcomment="Comment"

inn="INN (for natural persons)/OKPO (for legal entities)">

<pretension inn="INN (for natural persons)/OKPO (for legal entities)"

crdeal="Transaction identifier (reference)"

source="Disputing type (Code from ref.48)"

sourceref="Disputing type (Value from ref.48)"

claim="Subject of dispute (Code from ref. 69)"

                         claimref="Subject of dispute (Value from ref. 69)"

vdate="Date of the request creation" />

<commentcki comment="Commentary of the subject of credit history"

vdate="Date of a comment creation" />

<plost pser="Passport series claimed by the client as lost (theft)"

pnom="Passport number declared by the client as lost (theft)"

crdate="ДDate of creation of an application for the loss/theft of a client's passport in UBCH"

ldate="The date of loss / theft of the client's passport indicated in the application in UBCH" />

<changedeal crdeal="Transaction identifier (reference)"

changecode="Code for the reason of correction/deletion of data (Code from ref.62)"

changeref="Text of the reason for correcting/deleting data (Value from ref.62)"

vdate="Date of data correction/deletion" />

</pret>

<fcert inn="TIN"

cert="Availability of a certificate from the UBCH (code from ref. 56) - 0 - no (no registered certificate), 1 - yes (registered certificate) "

certref="Availability of a certificate from the UBCH (value from ref. 56)"

certid="Certificate number"

certurl="Link to the certificate" />

<maybegone inn="TIN"

vdate="Application creation date"

dldonor="Information provider (code from ref. 54)"/>

</comp>

<!-- Block of information from the list of sanctions -->

<comp id="40" descr="Information from sanctions lists">

<sanctions found="Availability of information (Code from ref. 27)"

foundRef="Text interpretation of available information (Code from ref. 27)"

subName="Subject’s name"

bDate="Subject’s date of birth"

position="Position"

reason="Grounds for imposing sanctions"

typeSearch="Search type (Code from ref. 67)"

typeSearchText="Text interpretation of the type of search (Code from ref. 67)">

<sanctionsData countryCode="Country code"

country="The name of the country"

sanction="Presence of sanctions imposed by the country (Code from ref. 68)"

date="Date of entry into the list"

url="Link to the document – confirmation" />

</sanctions>

<!--This block has to consist of 1 .. * elements -->

</comp>

<!-- "Information from the Public Register of Politically Exposed Persons of Ukraine" part-->

<comp id="41" descr="Information from the Public Register of Politically Exposed Persons of Ukraine">

<pep found="0 – not located, 1 – located "

foundref="not located/located"

subname="Subject’s name"

bdate="Subject’s date of birth"

category="Category of the politically exposed person"

lastpost="Last position"

dateofrelease="Date of leaving of the last position"

isur="Indication of legal entity"

state="Status of legal entity"

url="Link to the document – confirmation" />

<!--This block has to consist of 1 .. * elements-->

</comp>

<!-- Confirmation of the credit history subject’s contacts part -->

<comp id="46" descr="Names of components">

<contact cval="Contact value"

ctype="Contact type (code from ref.10)"

ctyperef="Contact type in text format (ref.10)"

cstate="Contact’s status (code from ref.57)"

cstateref="Contact’s status (text value from ref.57)"

vdatestart="First actualization date"

vdate="Last actualization date" />

<!--This part can contain 0..* items -->

</comp>

<!-- Bankruptcy information-->

<comp id="54" descr="Bankruptcy information">

<bankruptcyinfo found="Availability of information about bankruptcy, numerical designation 0-1"

foundref=" Availability of information about bankruptcy, textual meaning 0-not found / 1-found">

<bankruptcy subname="Subject’s name"

subcode="TIN/EDRPOU"

eventtype="Event type"

eventclaimer="Initiator of the event"

eventcourtcase="Case number"

eventdate="Date of event" />

</bankruptcyinfo>

</comp>

<!-- Additional information about CHS-->

<comp id="68" descr="Additional information about CHS">

<fcert inn="TIN"

cert="Availability of a certificate from the UBCH (code from ref. 56) - 0 - no (no registered certificate), 1 - yes (registered certificate) "

certref="Availability of a certificate from the UBCH (value from ref. 56)"

certid="Certificate number"

certurl="Link to the certificate" />

<maybegone inn="TIN"

vdate="Application creation date"

dldonor="Information provider (code from ref. 54)"/>

</comp>

<!-- Search by full name + inn if more than 1 person is found (The presence of the component is determined by searching for more than 1 person in the case of searching by full name + inn)-->

<comp id="72" descr="Search by full name + inn if more than 1 person is found">

<person bdate="Date of birth"

lngref="Search/transfer language (ref. 23)"

lng="Part presentation language, value (ref. 23)"

mname="Middle name"

fname="First name"

lname="Last name"

inn="TIN of the credit history subject" />

</comp>

<!-- Information from the Register of persons who have restricted access to gambling establishments and/or participation in gambling (using credit funds) -->

<comp id="76" descr="The name of the component">

<ludomans found="Numerical indication of whether a person is found in the register - 0/1"

foundref="Textual definition of whether a person is found in the register:Not found (0)/Found (1)" >

<information searchType="Search type - 0/1/2/3"

searchTypeRef="Text definition of search type: No matches found (0)/Found by TIN (1)/Found by name and date of birth (2)/Found by last name, first name and date of birth (3)"

lastName="Last name"

firstName="Name"

middleName="Middle name"

dateOfBirth="Date of birth"

inn="TIN"

documentSeries="Document series"

documentNumber="Document number"

documentIssuedDate="Document issue date"

documentIssuedBy="Issuer"

documentOtherData="Other information about the document"

passport="Passport"

gender="Sex"

address="Address"

communication="Contacts"

stateCode="Country code"

rDateFrom="Period start date"

rDateTill="Period end date"

reason="Reason" />

<!--This block must consist of 0 .. * elements-->

</ludomans>

</comp>

</ubkidata>

Example

Example

Request JSON

{ "doc": { "ubki": { "req_envelope": { "req_xml": { "request": { "i": { "ident": { "bdate": "1989-10-05", "mname": "VASYLIVNA", "fname": "IRINA", "lname": "HARNA", "okpo": "3278508288" }, "docs": { "doc": { "dtype": "1", "dser": "АМ", "dnom": "578072" } }, "contacts": { "cont": { "cval": "+380962134234", "ctype": "3" } }, "reqlng": "4" }, "version": "1.0", "reqtype": "10", "reqreason": "2" } } }, "sessid": "7AC5104A93364D8FB7A9DBF50C963CE3" } } }

Response JSON

{ "ubkidata": { "tech": { "trace": { "step": { "name": "build report", "stm": "2022-11-07 14:27:05.229", "ftm": "2022-10-07 14:27:05.715" } }, "reqinfo": { "reqid": "req2#000002481742" } }, "comp": [ { "cki": { "ident": [ { "cchild": "", "sstateref": "", "sstate": "", "spdref": "natural person", "spd": "1", "cgragref": "Ukraine", "cgrag": "804", "ceducref": "", "ceduc": "", "familyref": "", "family": "", "csexref": "woman", "csex": "2", "bdate": "1989-10-05", "mname": "ВАСИЛІВНА", "fname": "ІРІНА", "lname": "ГАРНА", "inn": "3278508288", "lngref": "Ukrainian", "lng": "1", "vdate": "2022-04-25", "donor": "BNK" }, { "cchild": "", "sstateref": "", "sstate": "", "spdref": "natural person", "spd": "1", "cgragref": "", "cgrag": "802", "ceducref": "", "ceduc": "", "familyref": "", "family": "", "csexref": "woman", "csex": "2", "bdate": "1989-10-05", "mname": "ВАСИЛІВНА", "fname": "ІРИНА", "lname": "ГАРНА", "inn": "3278508288", "lngref": "Ukrainian", "lng": "1", "vdate": "2007-10-04", "donor": "BNK" } ], "doc": { "dwdt": "2002-08-01", "dwho": "ІВАНГОРОДСЬКИМ", "dterm": "", "dnom": "578072", "dser": "АМ", "dtyperef": "Passport", "dtype": "1", "lngref": "Ukrainian", "lng": "1", "vdate": "2022-04-10", "eddr_number": "19891005-00022", "ddonor": "BNK" }, "addr": { "adflat": "", "adcorp": "", "adhome": "7", "adstreet": "ТИХА", "adcitytyperef": "", "adcitytype": "", "adcity": "JВDКВJ", "adarea": "ІВАНГОРОДСКИЙ", "adstate": "ДНЕПРОПЕТРОВСКАЯ", "adindex": "23201", "adcountry": "UA", "adtyperef": "Address of registration", "adtype": "2", "lngref": "Ukrainian", "lng": "1", "vdate": "2022-04-25", "addonor": "BNK" }, "bdate": "1989-10-05", "reqlngref": "Ukrainian", "reqlng": "1", "mname": "ВАСИЛІВНА", "fname": "ІРІНА", "lname": "ГАРНА", "inn": "3278508288" }, "identdocmvds": { "identdocmvd": { "foundsource": [ { "name": "MVS", "found": "1", "foundref": "Found", "sourcedate": "2022-10-16" }, { "name": "DMS", "found": "0", "foundref": "Not found", "sourcedate": "2022-10-16" }, { "name": "UBKI", "found": "0", "foundref": "Not found", "sourcedate": "2022-10-16" } ], "found": "1", "foundref": "Found", "foundtitle": "Passport АМ-578072 is found in the list of invalid passports.", "pser": "АМ", "pnom": "578072", "dtype": "1", "dtyperef": "Passport" } }, "id": "1", "descr": "Identification of the Credit History Subject (CHS)" }, { "crdeal": [ { "deallife": [ { "dldateclc": "2018-02-28", "dlfluseref": "No", "dlfluse": "0", "dlflbrkref": "No", "dlflbrk": "0", "dlflpayref": "No", "dlflpay": "0", "dldayexp": "0", "dlamtexp": "0.00", "dlamtcur": "0.00", "dlamtpaym": "0.00", "dlamtlim": "5000.00", "dlflstatref": "Open", "dlflstat": "1", "dldff": "", "dldpf": "2115-10-25", "dlds": "2015-09-25", "dlyear": "2018", "dlmonth": "2", "dlref": "00012016890" }, { "dldateclc": "2018-03-28", "dlfluseref": "No", "dlfluse": "0", "dlflbrkref": "No", "dlflbrk": "0", "dlflpayref": "No", "dlflpay": "0", "dldayexp": "0", "dlamtexp": "0.00", "dlamtcur": "0.00", "dlamtpaym": "0.00", "dlamtlim": "5000.00", "dlflstatref": "Open", "dlflstat": "1", "dldff": "", "dldpf": "2115-10-25", "dlds": "2015-09-25", "dlyear": "2018", "dlmonth": "3", "dlref": "00012016890" }, { "dldateclc": "2018-04-28", "dlfluseref": "No", "dlfluse": "0", "dlflbrkref": "No", "dlflbrk": "0", "dlflpayref": "No", "dlflpay": "0", "dldayexp": "0", "dlamtexp": "0.00", "dlamtcur": "0.00", "dlamtpaym": "0.00", "dlamtlim": "5000.00", "dlflstatref": "Open", "dlflstat": "1", "dldff": "", "dldpf": "2115-10-25", "dlds": "2015-09-25", "dlyear": "2018", "dlmonth": "4", "dlref": "00012016890" }, { "dldateclc": "2018-05-28", "dlfluseref": "No", "dlfluse": "0", "dlflbrkref": "No", "dlflbrk": "0", "dlflpayref": "No", "dlflpay": "0", "dldayexp": "0", "dlamtexp": "0.00", "dlamtcur": "0.00", "dlamtpaym": "0.00", "dlamtlim": "5000.00", "dlflstatref": "Open", "dlflstat": "1", "dldff": "", "dldpf": "2115-10-25", "dlds": "2015-09-25", "dlyear": "2018", "dlmonth": "5", "dlref": "00012016890" }, { "dldateclc": "2018-06-28", "dlfluseref": "No", "dlfluse": "0", "dlflbrkref": "No", "dlflbrk": "0", "dlflpayref": "No", "dlflpay": "0", "dldayexp": "0", "dlamtexp": "0.00", "dlamtcur": "0.00", "dlamtpaym": "0.00", "dlamtlim": "5000.00", "dlflstatref": "Open", "dlflstat": "1", "dldff": "", "dldpf": "2115-10-25", "dlds": "2015-09-25", "dlyear": "2018", "dlmonth": "6", "dlref": "00012016890" }, { "dldateclc": "2018-07-28", "dlfluseref": "No", "dlfluse": "0", "dlflbrkref": "No", "dlflbrk": "0", "dlflpayref": "No", "dlflpay": "0", "dldayexp": "0", "dlamtexp": "0.00", "dlamtcur": "0.00", "dlamtpaym": "0.00", "dlamtlim": "5000.00", "dlflstatref": "Open", "dlflstat": "1", "dldff": "", "dldpf": "2115-10-25", "dlds": "2015-09-25", "dlyear": "2018", "dlmonth": "7", "dlref": "00012016890" }, { "dldateclc": "2018-08-28", "dlfluseref": "No", "dlfluse": "0", "dlflbrkref": "No", "dlflbrk": "0", "dlflpayref": "No", "dlflpay": "0", "dldayexp": "0", "dlamtexp": "0.00", "dlamtcur": "0.00", "dlamtpaym": "0.00", "dlamtlim": "5000.00", "dlflstatref": "Open", "dlflstat": "1", "dldff": "", "dldpf": "2115-10-25", "dlds": "2015-09-25", "dlyear": "2018", "dlmonth": "8", "dlref": "00012016890" }, { "dldateclc": "2018-09-28", "dlfluseref": "No", "dlfluse": "0", "dlflbrkref": "No", "dlflbrk": "0", "dlflpayref": "No", "dlflpay": "0", "dldayexp": "0", "dlamtexp": "0.00", "dlamtcur": "0.00", "dlamtpaym": "0.00", "dlamtlim": "0.00", "dlflstatref": "Close", "dlflstat": "2", "dldff": "2018-09-12", "dldpf": "2115-10-25", "dlds": "2015-09-25", "dlyear": "2018", "dlmonth": "9", "dlref": "00012016890" } ], "dlamtobes": "", "dlrolesubref": "Borrower", "dlrolesub": "1", "dldonor": "BNK", "dlamt": "0.00", "dlcurrref": "Ukrainian hryvnia", "dlcurr": "980", "dlporpogref": "Credit with the personalized amortization schedule", "dlporpog": "7", "dlvidobesref": "", "dlvidobes": "", "dlcelcredref": "Credit card", "dlcelcred": "31", "bdate": "1989-10-05", "mname": "ВАСИЛІВНА", "fname": "ІРІНА", "lname": "ГАРНА", "inn": "3278508288", "lngref": "Ukrainian", "lng": "1", "dlref": "00012016890" }, { "deallife": [ { "dldateclc": "2019-01-03", "dlfluseref": "No", "dlfluse": "0", "dlflbrkref": "No", "dlflbrk": "0", "dlflpayref": "Yes", "dlflpay": "1", "dldayexp": "0", "dlamtexp": "0.00", "dlamtcur": "8999.00", "dlamtpaym": "0.00", "dlamtlim": "0.00", "dlflstatref": "Open", "dlflstat": "1", "dldff": "", "dldpf": "2020-05-23", "dlds": "2018-12-23", "dlyear": "2019", "dlmonth": "1", "dlref": "1000009435" }, { "dldateclc": "2019-02-04", "dlfluseref": "No", "dlfluse": "0", "dlflbrkref": "No", "dlflbrk": "0", "dlflpayref": "Yes", "dlflpay": "1", "dldayexp": "0", "dlamtexp": "0.00", "dlamtcur": "7199.00", "dlamtpaym": "1800.00", "dlamtlim": "0.00", "dlflstatref": "Open", "dlflstat": "1", "dldff": "", "dldpf": "2020-05-23", "dlds": "2018-12-23", "dlyear": "2019", "dlmonth": "2", "dlref": "1000009435" }, { "dldateclc": "2019-03-04", "dlfluseref": "No", "dlfluse": "0", "dlflbrkref": "No", "dlflbrk": "0", "dlflpayref": "Yes", "dlflpay": "1", "dldayexp": "0", "dlamtexp": "0.00", "dlamtcur": "5399.00", "dlamtpaym": "1800.00", "dlamtlim": "0.00", "dlflstatref": "Open", "dlflstat": "1", "dldff": "", "dldpf": "2020-05-23", "dlds": "2018-12-23", "dlyear": "2019", "dlmonth": "3", "dlref": "1000009435" }, { "dldateclc": "2019-04-05", "dlfluseref": "No", "dlfluse": "0", "dlflbrkref": "No", "dlflbrk": "0", "dlflpayref": "Yes", "dlflpay": "1", "dldayexp": "0", "dlamtexp": "0.00", "dlamtcur": "3599.00", "dlamtpaym": "1800.00", "dlamtlim": "0.00", "dlflstatref": "Open", "dlflstat": "1", "dldff": "", "dldpf": "2020-05-23", "dlds": "2018-12-23", "dlyear": "2019", "dlmonth": "4", "dlref": "1000009435" }, { "dldateclc": "2019-05-04", "dlfluseref": "No", "dlfluse": "0", "dlflbrkref": "No", "dlflbrk": "0", "dlflpayref": "Yes", "dlflpay": "1", "dldayexp": "0", "dlamtexp": "0.00", "dlamtcur": "1799.00", "dlamtpaym": "1800.00", "dlamtlim": "0.00", "dlflstatref": "Open", "dlflstat": "1", "dldff": "", "dldpf": "2020-05-23", "dlds": "2018-12-23", "dlyear": "2019", "dlmonth": "5", "dlref": "1000009435" }, { "dldateclc": "2019-06-03", "dlfluseref": "No", "dlfluse": "0", "dlflbrkref": "No", "dlflbrk": "0", "dlflpayref": "Yes", "dlflpay": "1", "dldayexp": "0", "dlamtexp": "0.00", "dlamtcur": "0.00", "dlamtpaym": "0.00", "dlamtlim": "0.00", "dlflstatref": "Close", "dlflstat": "2", "dldff": "2019-06-23", "dldpf": "2020-05-23", "dlds": "2019-01-23", "dlyear": "2019", "dlmonth": "6", "dlref": "1000009435" } ], "dlamtobes": "0.00", "dlrolesubref": "Borrower", "dlrolesub": "1", "dldonor": "BNK", "dlamt": "0.00", "dlcurrref": "Ukrainian hryvnia", "dlcurr": "980", "dlporpogref": "Credit with the monthly payments (including with the annuities)", "dlporpog": "6", "dlvidobesref": "Non-collateral (blank)", "dlvidobes": "90", "dlcelcredref": "Credit contract for other consumer purposes", "dlcelcred": "7", "bdate": "1989-10-05", "mname": "ВАСИЛІВНА", "fname": "ІРІНА", "lname": "ГАРНА", "inn": "3278508288", "lngref": "Ukrainian", "lng": "1", "dlref": "1000009435" } ], "id": "2", "descr": "Financial liabilities of CHS" }, { "penaltiesCount": { "totalCount": "2", "activeCount": "1" }, "susd": [ { "changes": { "voteid": "59931217", "inn": "3278508288", "votedate": "2019-09-09", "votesudname": "Деснянський районний відділ державної виконавчої служби у місті Києві Центрального міжрегіонального управління Міністерства юстиції (м. Київ)", "vdate": "2020-01-20", "credname": "УПРАВЛІННЯ ПАТРУЛЬНОЇ СЛУЖБИ МІНІСТЕРСТВА ВНУТРІШНІХ СПРАВ У МІСТІ КИЄВІ", "credokpo": "34003114", "vpstate": "Відкрито" }, "votesudname": "Деснянський районний відділ державної виконавчої служби у місті Києві Центрального міжрегіонального управління Міністерства юстиції (м. Київ)", "votetype": "стягнення заборгованості з оплати комунальних послуг", "votedate": "2019-09-09", "inn": "3278508288", "voteid": "59931217", "votedonor": "Інформація з автоматизованої системи виконавчого провадження", "votesudphone": "(05235) 4-01-42, 4-01-41", "votesudemail": "saharov33@gmail.com", "vdate": "2020-05-18", "credname": "УПРАВЛІННЯ ПАТРУЛЬНОЇ СЛУЖБИ МІНІСТЕРСТВА ВНУТРІШНІХ СПРАВ У МІСТІ КИЄВІ", "credokpo": "34003114", "vpstate": "Завершено" }, { "votesudname": "Деснянський районний відділ державної виконавчої служби у місті Києві Центрального міжрегіонального управління Міністерства юстиції (м. Київ)", "votetype": "стягнення у справах про адміністративні правопорушення (крім безпеки дорожнього руху)", "votedate": "2019-08-06", "inn": "3278508288", "voteid": "59715537", "votedonor": "Інформація з автоматизованої системи виконавчого провадження", "votesudphone": "(05235) 4-01-42, 4-01-41", "votesudemail": "yu.dolia@gov.ua", "vdate": "2019-12-11", "credname": "Управління Патрульної поліції у м. Києв", "credokpo": "34003114", "vpstate": "Примусове виконання" } ], "id": "3", "descr": "Information about enforcement proceedings of CHS" }, { "credres": [ { "org": "BNK", "reqreasonref": "Verification", "reqreason": "6", "resultref": "Report provided successfully", "result": "1", "reqid": "req2#000002481696", "inn": "3278508288", "redate": "2022-10-07", "retime": "11:46:13", "typereport": "2", "typereportref": "Credit history" }, { "org": "OWN", "reqreasonref": "Credit request", "reqreason": "2", "resultref": "Report provided successfully", "result": "1", "reqid": "req2#000002481522", "inn": "3278508288", "redate": "2022-10-07", "retime": "08:53:45", "typereport": "2", "typereportref": "Credit history" }, { "org": "BNK", "reqreasonref": "Credit request", "reqreason": "2", "resultref": "Report provided successfully", "result": "1", "reqid": "req2#000002481480", "inn": "3278508288", "redate": "2022-10-07", "retime": "01:13:30", "typereport": "2", "typereportref": "Credit history" }, { "org": "MFO", "reqreasonref": "Credit request", "reqreason": "2", "resultref": "Report provided successfully", "result": "1", "reqid": "req2#000002441565", "inn": "3278508288", "redate": "2022-07-11", "retime": "11:44:07", "typereport": "2", "typereportref": "Credit history" }, { "org": "OWN", "reqreasonref": "Credit request", "reqreason": "2", "resultref": "Report provided successfully", "result": "1", "reqid": "req2#000001971404", "inn": "3278508288", "redate": "2022-01-04", "retime": "14:33:45", "typereport": "2", "typereportref": "Credit history" }, { "org": "BNK", "reqreasonref": "Credit request", "reqreason": "2", "resultref": "Report provided successfully", "result": "1", "reqid": "req2#000001970535", "inn": "3278508288", "redate": "2022-01-04", "retime": "11:54:21", "typereport": "2", "typereportref": "Credit history" }, { "org": "OWN", "reqreasonref": "Credit request", "reqreason": "2", "resultref": "Report provided successfully", "result": "1", "reqid": "req2#000001965556", "inn": "3278508288", "redate": "2022-01-03", "retime": "18:56:09", "typereport": "2", "typereportref": "Credit history" }, { "org": "BNK", "reqreasonref": "Credit request", "reqreason": "2", "resultref": "Report provided successfully", "result": "1", "reqid": "req2#000001965551", "inn": "3278508288", "redate": "2022-01-03", "retime": "18:55:44", "typereport": "2", "typereportref": "Credit history" } ], "reestrtime": { "hr": "0", "da": "4", "wk": "10", "mn": "54", "qw": "129", "ye": "378", "yu": "0" }, "id": "4", "descr": "Inquiries registry" }, { "id": "5", "descr": "Search for canceled documents" }, { "moncredres": [ { "org": "BNK", "resultref": "Report provided successfully", "result": "1", "monid": "MD4D0922689A4C684", "inn": "3278508288", "startdate": "2022-03-16", "enddate": "2022-03-16" }, { "org": "FIN", "resultref": "Report provided successfully", "result": "1", "monid": "M7550A09354641E30", "inn": "3278508288", "startdate": "2022-01-25", "enddate": "2022-01-25" }, { "org": "MFO", "resultref": "Report provided successfully", "result": "1", "monid": "MFEBBA0EFA1405284", "inn": "3278508288", "startdate": "2022-05-25", "enddate": "2022-09-14" }, { "org": "MFO", "resultref": "Report provided successfully", "result": "1", "monid": "M5D7749BB7543C25D", "inn": "3278508288", "startdate": "2022-04-26", "enddate": "2022-09-08" } ], "id": "6", "descr": "Monitoring (does not affect credit rating)" }, { "cont": [ { "cval": "+380662134234", "ctyperef": "mobile phone", "ctype": "3", "vdate": "2022-04-28", "cdonor": "BNK" }, { "cval": "+380962134234", "ctyperef": "mobile phone", "ctype": "3", "vdate": "2021-10-28", "cdonor": "BNK" } ], "id": "10", "descr": "Contacts" }, { "utilitiesdebt": { "utldebt": { "debtDate": "2023-06-08", "totalDebt": "8813.54", "expDebt": "8386.82", "debtMonthNumber": "18" }, "inn": "3278508288", "branch": "ПОКРОВСК", "account": "999999999", "accountDate": "2019-01-01", "utltypetype": "10", "utltypetyperef": "Електроенергія", "isDebtState": "true", "dbDate": "2023-06-21" }, "id": "11", "descr": "Debt for communal services" }, { "wantedmvs": { "found": "0", "foundref": "No information found", "bdate": "1989-10-05", "lng": "1", "lngref": "Ukrainian", "lname": "ГАРНА", "fname": "ІРІНА", "mname": "ВАСИЛІВНА", "url": "", "category": "", "articlecrim": "", "restraint": "" }, "id": "17", "descr": "Search in the MIA search database" }, { "pret": { "inn": "3278508288", "nonewdeal": "0", "nonewdealref": "No", "nonewdealcomment": "", "freezedate": "" }, "fcert": { "inn": "3278508288", "cert": "0", "certref": "No", "certid": "", "certurl": "" }, "maybegone": { "inn": "3278508288", "vdate": "2022-12-01", "dldonor": "BNK" }, "id": "18", "descr": "Alert" }, { "sanctions": { "sanctionsData": [ { "countryCode": "EU", "country": "ЄВРОПЕЙСЬКИЙ СОЮЗ", "sanction": "0", "date": "", "url": "" }, { "countryCode": "AU", "country": "АВСТРАЛІЯ", "sanction": "1", "date": "2022-05-18", "url": "https://www.dfat.gov.au/international-relations/security/sanctions/consolidated-list" }, { "countryCode": "CH", "country": "ШВЕЙЦАРІЯ", "sanction": "0", "date": "", "url": "" }, { "countryCode": "JP", "country": "ЯПОНІЯ", "sanction": "0", "date": "", "url": "" }, { "countryCode": "GB", "country": "СПОЛУЧЕНЕ КОРОЛІВСТВО", "sanction": "0", "date": "", "url": "" }, { "countryCode": "UA", "country": "УКРАЇНА", "sanction": "1", "date": "2021-02-02", "url": "https://www.president.gov.ua/documents/432021-36441" }, { "countryCode": "NZ", "country": "НОВА ЗЕЛАНДІЯ", "sanction": "1", "date": "2022-05-03", "url": "https://www.mfat.govt.nz/en/countries-and-regions/europe/ukraine/russian-invasion-of-ukraine/sanctions" }, { "countryCode": "PL", "country": "ПОЛЬЩА", "sanction": "0", "date": "", "url": "" }, { "countryCode": "US", "country": "СПОЛУЧЕНІ ШТАТИ АМЕРИКИ", "sanction": "1", "date": "2022-01-20", "url": "https://home.treasury.gov/policy-issues/financial-sanctions/recent-actions/20220120" }, { "countryCode": "CA", "country": "КАНАДА", "sanction": "1", "date": "2022-02-24", "url": "https://gazette.gc.ca/rp-pr/p2/2022/2022-03-16/html/sor-dors30-eng.html" } ], "found": "1", "foundRef": "Found information", "subName": "ГАРНА ІРІНА ВАСИЛІВНА", "bDate": "05.10.1989", "position": "Народний депутат Верховної Ради IX скликання («Опозиційна платформа — за життя»)", "reason": "Дестабілізація ситуації в Україні", "typeSearch": "0", "typeSearchText": "Found by name and date of birth" }, "id": "40", "descr": "Information from sanctions lists" }, { "pep": { "found": "0", "foundref": "No information found", "subname": "ГАРНА ІРІНА ВАСИЛІВНА", "bdate": "1989-10-05", "category": "", "lastpost": "", "dateofrelease": "", "isur": "", "state": "", "url": "", "typesearch": "-1", "typesearchtext": "No person was found for any search parameters" }, "id": "41", "descr": "Information from the public register of politically exposed persons of Ukraine" }, { "contact": [ { "cval": "+380662134234", "ctype": "3", "ctyperef": "mobile phone", "cstate": "1", "cstateref": "Actualization", "vdatestart": "2020-09-03", "vdate": "2020-09-08" }, { "cval": "+380111111111", "ctype": "3", "ctyperef": "mobile phone", "cstate": "2", "cstateref": "Deactualization", "vdatestart": "2020-06-12", "vdate": "2020-08-30" } ], "id": "46", "descr": "Сontacts confirmation of the subject of the credit history" }, { "bankruptcyinfo": { "bankruptcy": [ { "subname": "ГАРНА ІРІНА ВАСИЛІВНА", "subcode": "3278508288", "eventtype": "Інформація про поновлення справи про банкрутство", "eventclaimer": "Вищий господарський суд України (vgsu.arbitr.gov.ua)", "eventcourtcase": "910/3551/21", "eventdate": "2021-04-14" }, { "subname": "ГАРНА ІРІНА ВАСИЛІВНА", "subcode": "3278508288", "eventtype": "Інформація про порушення справи про банкрутство", "eventclaimer": "Вищий господарський суд України (vgsu.arbitr.gov.ua)", "eventcourtcase": "910/3551/21", "eventdate": "2021-10-06" } ], "found": "1", "foundref": "Знайдена інформація про банкрутство" }, "id": "54", "descr": "Bankruptcy information" }, { "fcert": { "inn": "3278508288", "cert": "0", "certref": "No", "certid": "", "certurl": "" }, "maybegone": { "inn": "3278508288", "vdate": "2022-12-01", "dldonor": "BNK" }, "id": "68", "descr": "Additional information about the credit history subject" }, { "ludomans":{ "found": 0, "foundref":"Not found in the registry of ludomaniacs", "information": [] }, "id": "76", "descr": "Information from the Register of persons who have restricted access to gambling establishments and/or participation in gambling (using credit funds)" } ] } }

Request XML

<?xml version="1.0" encoding="UTF-8"?> <doc> <ubki sessid="7AC5104A93364D8FB7A9DBF50C963CE3"> <req_envelope> <req_xml> <request version="1.0" reqtype="10" reqreason="2"> <i reqlng="4"> <ident bdate="1989-10-05" mname="VASYLIVNA" fname="IRINA" lname="HARNA" okpo="3278508288" /> <docs> <doc dtype="1" dser="АМ" dnom="578072" /> </docs> <contacts> <cont cval="+380962134234" ctype="3" /> </contacts> </i> </request> </req_xml> </req_envelope> </ubki> </doc>

Response XML

Test URL

Test data

  • bdate="1991-03-30" mname="ПЕТРОВИЧ" fname="ВАДИМ" lname="НИКОЛАЕВ" okpo="3332643095" dtype="1" dser="ДО" dnom="270000" cval="+380981220000" ctype="3"

  • bdate="1974-08-20" mname="БОГДАНОВИЧ" fname="БОГДАН" lname="БОГДАНОВ" okpo="2726020593" dtype="17" dser="" dnom="001013900" cval="+380935171868" ctype="3"

  • bdate="1981-05-20" mname="ПЕТРОВНА" fname="МАРИЯ" lname="ИВАНЦОВА" okpo="2972566397" dtype="1" dser="СЕ" dnom="311111" cval="+380506630641" ctype="3"

  • bdate="1988-07-10" mname="ІВАНОВИЧ" fname="БОГДАН" lname="ПОШТАР" okpo="3233312116" dtype="1" dser="КО" dnom="220394" cval="+380971321122" ctype="3"

  • bdate="1991-04-06" mname="ВОЛОДИМИРОВИЧ" fname="ВОЛОДИМИР" lname="ТКАЧУК" okpo="3333312110" dtype="1" dser="ДД" dnom="222222" cval="+380732144444" ctype="3"

  • bdate="1985-03-20" mname="НИКИФОРОВНА" fname="АННА" lname="ЯРЦЕВА" okpo="3112579786" dtype="1" dser="СЮ" dnom="170000" cval="+380981224895" ctype="3"

  • bdate="1957-10-19" mname="ІГОРЕВНА" fname="АННА" lname="РИБАЧКА" okpo="2111118724" dtype="1" dser="ВВ" dnom="142228" cval="+380662134234" ctype="3"

  • bdate="1989-10-05" mname="ВАСИЛІВНА" fname="ІРІНА" lname="ГАРНА" okpo="3278508288" dtype="1" dser="АМ" dnom="578072" cval="+380962134234" ctype="3"

 

<comp id="11" descr="Debt for communal services">

  • bdate="1989-10-05" mname="ВАСИЛІВНА" fname="ІРІНА" lname="ГАРНА" okpo="3278508288" dtype="1" dser="АМ" dnom="578072" cval="+380962134234" ctype="3"

 

<comp id="14" descr="Information about a business entity">

  • bdate="1974-08-20" mname="БОГДАНОВИЧ" fname="БОГДАН" lname="БОГДАНОВ" okpo="2726020593" dtype="17" dser="" dnom="001013900" cval="+380935171868" ctype="3"

 

<comp id="17" descr="Search for Wanted Persons in the Ministry of Internal Affairs Database part">

  • bdate="1957-10-19" mname="ІГОРЕВНА" fname="АННА" lname="РИБАЧКА" okpo="2111118724" dtype="1" dser="ВВ" dnom="142228" cval="+380662134234" ctype="3"

 

<comp id="18" descr="Alert"> option Freeze

okpo="one of the examples below" lname="Ivanov" fname="Ivan" mname="Ivanovitch" bdate="1975-01-01" dser="AH" dnom="454241" cval="380671234567" ctype="3"

  • 2230428028

  • 2269501369

  • 2274214699

  • 2293515103

 

<comp id="18" descr="Alert"> tag <changedeal>

  • bdate="1991-03-30" mname="ПЕТРОВИЧ" fname="ВАДИМ" lname="НИКОЛАЕВ" okpo="3332643095" dtype="1" dser="ДО" dnom="270000" cval="+380981220000" ctype="3"

 

<comp id="40" descr="Information from sanctions lists">, <comp id="54" descr="Bankruptcy information">

  • bdate="1989-10-05" mname="ВАСИЛІВНА" fname="ІРІНА" lname="ГАРНА" okpo="3278508288" dtype="1" dser="АМ" dnom="578072" cval="+380962134234" ctype="3"

 

<comp id="41" descr="Information from the Public Register of Politically Exposed Persons of Ukraine"> 

  • bdate="1981-05-20" mname="ПЕТРОВНА" fname="МАРИЯ" lname="ИВАНЦОВА" okpo="2972566397" dtype="1" dser="СЕ" dnom="311111" cval="+380506630641" ctype="3"

 

<comp id="46" descr="Confirmation of the credit history subject’s contacts">

  • bdate="1957-10-19" mname="ІГОРЕВНА" fname="АННА" lname="РИБАЧКА" okpo="2111118724" dtype="1" dser="ВВ" dnom="142228" cval="+380662134234" ctype="3"

  • bdate="1989-10-05" mname="ВАСИЛІВНА" fname="ІРІНА" lname="ГАРНА" okpo="3278508288" dtype="1" dser="АМ" dnom="578072" cval="+380962134234" ctype="3"

 

<comp id="68" descr="Additional information about CHS">

  • bdate="1991-03-30" mname="ПЕТРОВИЧ" fname="ВАДИМ" lname="НИКОЛАЕВ" okpo="3332643095" dtype="1" dser="ДО" dnom="270000" cval="+380981220000" ctype="3"

  • bdate="1957-10-19" mname="ІГОРЕВНА" fname="АННА" lname="РИБАЧКА" okpo="2111118724" dtype="1" dser="ВВ" dnom="142228" cval="+380662134234" ctype="3"

  • bdate="1989-10-05" mname="ВАСИЛІВНА" fname="ІРІНА" lname="ГАРНА" okpo="3278508288" dtype="1" dser="АМ" dnom="578072" cval="+380962134234" ctype="3"

 

<comp id="72" descr="Search by full name + inn if more than 1 person is found">

  • bdate="1985-03-20" mname="НИКИФОРОВНА" fname="АННА" lname="ЯРЦЕВА"