...

Request JSON

Expand
title body:

{

"doc": {

"ubki": {

"req_envelope": {

"req_xml": {

"request": {

"i": {

"ident": {

"okpo": "EGRPOU (for legal entities)"

},

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

},

"version": "1.0",

"reqtype": "Template code (Code from the ref.49): 'Credit report of a legal entity ' - 15",

"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 XML

Expand
titlebody:

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

<ubkidata>

<!-- System information block -->

<tech>

<trace>

<step name="Step name" stm="Date-stamp of the step start" ftm="Date-stamp of the step end">

<!-- The trace block contains the timing metrics of the components formation steps -->

</step>

</trace>

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

</error>

<reqinfo reqid="The outgoing ID request, generated by the Ukrainian Bureau of the Credit History">

</reqinfo>

<!-- Block of information on the current state of the prepaid account-->

<billing>

<balance value="Balance amount" date="Date" time="Time" />

</billing>

</tech>

<!-- Identification block -->

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

<cki inn="EGPROU of the legal entity"

lname="Name of the legal entity"

reqlng="Search language (during search)/Identification language (during transmission) (Code from ref.23)"

reqlngref="Search language (during search)/Identification language (during transmission) (Meaning from ref.23)">

<!-- Block of the legal entity identification history-->

<urident donor="A source of information (code from ref.54)"

vdate="Date of this block information"

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

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

okpo="EGRPOU of the legal entity"

urname="Name of the legal entity"

urfrms="Form of ownership (Code from ref.38)"

urfrmsref="Form of ownership (Meaning from ref.38)"

ureconom="Branch of economy (Section KVED2010) (Code from ref.36)"

ureconomref="Branch of economy (Section KVED2010) (Meaning from ref.36)"

urvide="Business activity (KVED2010) (Code from ref.37)"

urvideref="Business activity (KVED2010) (Code from ref.37)"

urdatreg="Date of registration in the Unified State Register"

urdatregnal="Date of registration in the tax inspectorate">

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

</urident>

<!-- Block of the related persons for the legal entities (Director, accountant ...)-->

<linked okpo2="INN/EGRPOU of the related person"

okpo2_name="Full name/Name of the related person"

linkrole="Type of connection (Code from ref.39)"

linkroleref="Type of connection (Meaning from ref.39)"

rdate="Connection updated date"(Code from ref.39)"

linkroleref="Type of connection (Meaning from ref.39)"

rdate="Connection updated date">

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

</linked>

<!-- 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 block can and has to consist of part must contain 1..* elementsunits and at least one document-->

</linked>doc>

<!-- Block of the Information History of addresses -->

<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 block has to consist of 1 .. * elements and has to be filled, at least, with 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 about Enforcement Proceedings of the Credit History Subject part -->

<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)">

<!--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>

<!-- 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 ref.19)"

monid="Unique Monitoring Identifier"

inn="TIN"

startdate="Monitoring start date"

enddate="Date of last monitoring " />

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

</comp>

<!-- Block – Counterparty Status -->

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

<stcont sinn="OKPO (for legal entities)"

sname="Name of the legal entity"

sdate="Registration date of the legal entity"

snds="VAT payer status (0 - NO/ 1- YES)"

sndsdate="Date updated"

sipn="Individual Tax Number"

saddr="Address"

dreg="Date of registration as VAT payer"

contacts="Contacts">

<state val="Current status (Сode from ref.41)"

valref="Value current status (Value of ref.41)"

setdate="Date updated"

src="A source of information (Сode from ref.42)"

srcref="Value source of information (Value of ref.42)" />

</stcont>

</comp>

<!-- Client 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)"

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)"

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>

</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 part can contain 1..* 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>

</ubkidata>

...

Response XML

Code Block
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ubkidata>
  <tech>
    <trace>
      <step name="build report" stm="2022-01-09 19:37:44.383" ftm="2022-01-09 19:37:44.451" />
    </trace>
    <reqinfo reqid="req2#000002007937" />
  </tech>
  <comp id="1" descr="Ідентифікація Суб’єкта кредитної історії (СКІ)">
    <cki reqlngref="Русский" reqlng="2" lname="ТОВ 'АМІРАН'" inn="12345610">
      <urident vdate="2019-03-12" lng="2" lngref="Русский" urname="ТОВ 'АМІРАН'" urfrms="" urfrmsref="" ureconom="" ureconomref="" urvide="" urvideref="" urdatreg="2005-06-27" urdatregnal="" />
      <urident vdate="2019-02-12" lng="2" lngref="Русский" urname="ТОВ 'АМІРАН'" urfrms="" urfrmsref="" ureconom="" ureconomref="" urvide="" urvideref="" urdatreg="2005-06-27" urdatregnal="" />
      <linked okpo2="2499021638" okpo2_name="ШЕВЧЕНКО ІГОР ОЛЕКСАНДРОВИЧ" linkrole="2" linkroleref="Руководитель" rdate="2019-07-07" />
      <doc dwdt="2005-06-27" dwho="ДЕПАРТАМЕНТ РЕЄСТРАЦІЇ ЖИТОМИРСЬКОЇ МІСЬКОЇ РАДИ" dterm="" dnom="11245600000003330" dser="null" dtyperef="Свидетельство про государственную регистрацию" dtype="11" lngref="Русский" lng="2" vdate="2019-04-10" eddr_number="" ddonor="BNK" />
      <addr adflat="" adcorp="" adhome="14" adstreet="РИБАЦЬКА" adcitytyperef="" adcitytype="" adcity="ЖИТОМИР" adarea="" adstate="ЖИТОМИРСЬКА" adindex="12613" adcountry="UA" adtyperef="Фактический адрес (юр.лицо)" adtype="3" lngref="Русский" lng="2" vdate="2019-07-07" addonor="BNK" />
      <addr adflat="" adcorp="" adhome="14" adstreet="РИБАЦЬКА" adcitytyperef="" adcitytype="" adcity="ЖИТОМИР" adarea="" adstate="ЖИТОМИРСЬКА" adindex="12613" adcountry="UA" adtyperef="Юридический адрес (юр.лицо)" adtype="4" lngref="Русский" lng="2" vdate="2019-03-12" addonor="BNK" />
    </cki>
    <identdocmvds />
  </comp>
  <comp id="2" descr="Фінансові зобов`язання СКІ">
    <crdeal dlamtobes="" dlrolesubref="Заемщик" dlrolesub="1" dldonor="BNK" dlamt="0.00" dlcurrref="Украинская гривня" dlcurr="980" dlporpogref="Кредит с индивидуальным графиком погашения" dlporpog="7" dlvidobesref="" dlvidobes="" dlcelcredref="Кредитний договір на поповнення обігових коштів" dlcelcred="1" bdate="" mname="" fname="" lname="ТОВ 'АМІРАН'" inn="12345610" lngref="Русский" lng="2" dlref="2075701">
      <deallife dldateclc="2020-05-28" dlfluseref="Да" dlfluse="1" dlflbrkref="Нет" dlflbrk="0" dlflpayref="Нет" dlflpay="0" dldayexp="0" dlamtexp="0.00" dlamtcur="49920.00" dlamtpaym="0.00" dlamtlim="0.00" dlflstatref="відкритий" dlflstat="1" dldff="" dldpf="2900-12-31" dlds="2020-05-01" dlyear="2020" dlmonth="5" dlref="2075701" />
      <deallife dldateclc="2020-06-28" dlfluseref="Нет" dlfluse="0" dlflbrkref="Нет" dlflbrk="0" dlflpayref="Нет" dlflpay="0" dldayexp="0" dlamtexp="0.00" dlamtcur="49920.00" dlamtpaym="0.00" dlamtlim="0.00" dlflstatref="відкритий" dlflstat="1" dldff="" dldpf="2900-12-31" dlds="2020-05-01" dlyear="2020" dlmonth="6" dlref="2075701" />
      <deallife dldateclc="2020-07-27" dlfluseref="Да" dlfluse="1" dlflbrkref="Нет" dlflbrk="0" dlflpayref="Да" dlflpay="1" dldayexp="0" dlamtexp="0.00" dlamtcur="0.00" dlamtpaym="0.00" dlamtlim="0.00" dlflstatref="відкритий" dlflstat="1" dldff="" dldpf="2900-12-31" dlds="2020-05-01" dlyear="2020" dlmonth="7" dlref="2075701" />
      <deallife dldateclc="2020-08-28" dlfluseref="Нет" dlfluse="0" dlflbrkref="Нет" dlflbrk="0" dlflpayref="Нет" dlflpay="0" dldayexp="0" dlamtexp="0.00" dlamtcur="0.00" dlamtpaym="0.00" dlamtlim="0.00" dlflstatref="відкритий" dlflstat="1" dldff="" dldpf="2900-12-31" dlds="2020-05-01" dlyear="2020" dlmonth="8" dlref="2075701" />
      <deallife dldateclc="2020-09-28" dlfluseref="Нет" dlfluse="0" dlflbrkref="Нет" dlflbrk="0" dlflpayref="Нет" dlflpay="0" dldayexp="0" dlamtexp="0.00" dlamtcur="0.00" dlamtpaym="0.00" dlamtlim="0.00" dlflstatref="відкритий" dlflstat="1" dldff="" dldpf="2900-12-31" dlds="2020-05-01" dlyear="2020" dlmonth="9" dlref="2075701" />
      <deallife dldateclc="2020-10-28" dlfluseref="Нет" dlfluse="0" dlflbrkref="Нет" dlflbrk="0" dlflpayref="Нет" dlflpay="0" dldayexp="0" dlamtexp="0.00" dlamtcur="0.00" dlamtpaym="0.00" dlamtlim="0.00" dlflstatref="закритий" dlflstat="2" dldff="2020-10-11" dldpf="2900-12-31" dlds="2020-05-01" dlyear="2020" dlmonth="10" dlref="2075701" />
    </crdeal>
  </comp>
  <comp id="3" descr="Інформація про виконавчі провадження СКІ">
    <penaltiesCount totalCount="0" activeCount="0" />
  </comp>
  <comp id="4" descr="Реєстр запитів">
    <credres org="BNK" reqreasonref="Заявка на кредит" reqreason="2" resultref="Звіт надано успішно" result="1" reqid="req2#000002002758" inn="12345610" redate="2022-01-09" retime="01:13:44" />
    <credres org="BNK" reqreasonref="Заявка на кредит" reqreason="2" resultref="Звіт надано успішно" result="1" reqid="req2#000001937306" inn="12345610" redate="2021-12-30" retime="16:28:00" />
    <credres org="NFN" reqreasonref="Заявка на кредит" reqreason="2" resultref="Звіт надано успішно" result="1" reqid="req2#000001665802" inn="12345610" redate="2021-10-04" retime="10:23:45" />
    <credres org="NFN" reqreasonref="Заявка на кредит" reqreason="2" resultref="Звіт надано успішно" result="1" reqid="req2#000001665440" inn="12345610" redate="2021-10-01" retime="13:10:47" />
    <reestrtime hr="0" da="1" wk="5" mn="4" qw="5" ye="34" yu="39" />
  </comp>
  <comp id="6" descr="Моніторинг (не впливає на кредитний рейтинг)" />
  <comp id="13" descr="Статус-Контрагента">
    <stcont sinn="12345610" sname="ТОВ 'АМІРАН'" sdate="2005-06-27" snds="0" sndsdate="2021-08-03" sipn="" saddr="12613 UA ЖИТОМИРСЬКА  ЖИТОМИР РИБАЦЬКА 14" dreg="" contacts="">
      <state val="0" valref="Нет информации о банкротстве или ликвидации" setdate="2021-08-04" src="0" srcref="Из публичных источников" />
      <state val="-1" valref="" setdate="" src="1" srcref="По данным Единого государственного реестра" />
    </stcont>
  </comp>
  <comp id="18" descr="Попередження від СКІ">
    <pret inn="12345610" nonewdeal="0" nonewdealref="Ні" nonewdealcomment="" />
  </comp>
  <comp id="40" descr="Information from sanctions lists">
    <sanctions found="1" foundRef="Found information" subName="ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ «Аміран»" bDate="" position="" reason="Запровадження санкцій проти провідних фінансових установ Росії серйозно підриває здатність Росії залучати капітал, необхідний для її загарбницьких дій. Санкції застосовуються до дочірніх компаній" typeSearch="0" typeSearchText="The search was conducted according to the TIN">
      <sanctionsData countryCode="EU" country="ЄВРОПЕЙСЬКИЙ СОЮЗ" sanction="0" date="" url="" />
      <sanctionsData countryCode="AU" country="АВСТРАЛІЯ" sanction="0" date="" url="" />
      <sanctionsData countryCode="CH" country="ШВЕЙЦАРІЯ" sanction="1" date="2014-08-27" url="" />
      <sanctionsData countryCode="JP" country="ЯПОНІЯ" sanction="0" date="" url="" />
      <sanctionsData countryCode="GB" country="СПОЛУЧЕНЕ КОРОЛІВСТВО" sanction="0" date="" url="" />
      <sanctionsData countryCode="UA" country="УКРАЇНА" sanction="1" date="2021-03-19" url="https://www.president.gov.ua/documents/1072021-37425" />
      <sanctionsData countryCode="NZ" country="НОВА ЗЕЛАНДІЯ" sanction="0" date="" url="" />
      <sanctionsData countryCode="PL" country="ПОЛЬЩА" sanction="0" date="" url="" />
      <sanctionsData countryCode="US" country="СПОЛУЧЕНІ ШТАТИ АМЕРИКИ" sanction="1" date="2015-12-22" url="https://home.treasury.gov/policy-issues/financial-sanctions/recent-actions/20151222 https://home.treasury.gov/policy-issues/financial-sanctions/recent-actions/20220224" />
      <sanctionsData countryCode="CA" country="КАНАДА" sanction="0" date="" url="" />
    </sanctions>
  </comp>
  <comp id="41" descr="Інформація з відкритого реєстру національних публічних діячів України">
    <pep found="0" foundref="Інформація не знайдена" subname="" bdate="" category="" lastpost="" dateofrelease="" isur="" state="" url="" typesearch="-1" typesearchtext="Суб'єкт не належить до публічних осіб" />
  </comp>
  <comp id="54" descr="Інформація щодо банкрутства">
    <bankruptcyinfo found="1" foundref="Знайдена інформація про банкрутство">
      <bankruptcy subname="ТОВ 'АМІРАН'" subcode="12345610" eventtype="Повідомлення про постановлення судового рішення щодо порушення провадження у справі про банкрутство юридичної особи" eventclaimer="Бюлетень Державної Реєстрації" eventcourtcase="" eventdate="2013-11-28" />
    </bankruptcyinfo>
  </comp>
</ubkidata>

...