Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

Identification of the individual.

...

Info
Звіт містить такі компоненти

The report contains the following components:

...

Http Method

...

POST

...

Request URL

...

Request

XML

JSON
( **

параметри передаються опціонально при наявністі кредитної історії по даному клієнту від Вашої організації

<comp id="41" descr="Інформація з відкритого реєстру національних громадських діячів України">

<pep found="Знайдений? (Код із дов.27)"

foundref="Знайдений? (Значение із дов.27)"

subname="Найменування суб'єкта"

bdate="Дата народження суб'єкта"

category="Категорія публічного діяча"

lastpost="Остання посада"

dateofrelease="Дата звільнення з останньої посади"

isur="Ознака юр.особи"

state="Статус юр.особи"

url="Посилання на документ-підтвердження"

typesearch="Тип пошуку (0 - пошук по ПІБ та ДН, 1 пошук по ПІБ, -1 - нічого не знайдено)"

typesearchtext="Текстове тлумачення типу пошуку (0 - Знайдено по ПІБ та датою народження, 1 - Знайдено по ПІБ, можливі збіги з іншими суб'єктами з однаковими даними, -1 - Суб'єкт не належить до публічних осіб)" />

<!--Даний блок повинен складатися з 1 .. * елементів -->

</comp>

<!-- Блок підтвердження контактів СКІ -->

<comp id="46" descr="Назва компоненти">

<contact cval="Значення контакту"

ctype="Тип контакту (Код із дов.10)"

ctyperef="Тип контакту в текстовому вигляді (Значення із дов.10)"

cstate="Статус контакту (Код із дов.57)"

cstateref="Статус контакту (Текстове значення із дов.57)"

vdatestart="Дата першої актуалізації"

vdate="Дата останньої актуалізації" />

<!--Даний блок може складатися з 0 .. * елементів -->

</comp>

</ubkidata>

Приклад

Request

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<doc>
  <ubki sessid="7BD7E136E3BF470EAA2CFE2E8700000D">
    <req_envelope descr="Конверт запиту">
      <req_xml descr="Об'єкт запиту">
        <request version="1.0" reqtype="12" reqreason="2">
          <i reqlng="1">
            <ident bdate="1989-10-05" mname="ВАСИЛІВНА" fname="ІРІНА" lname="ГАРНА" 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

Code Block
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ubkidata>
  <tech>
    <trace>
      <step name="build report" stm="2022-01-09 19:22:31.946" ftm="2022-01-09 19:22:32.021" />
    </trace>
    <reqinfo reqid="req2#000002007864" />
  </tech>
  <comp id="1" descr="Ідентифікація Суб’єкта кредитної історії (СКІ)">
    <cki bdate="1989-10-05" reqlngref="Украинский" reqlng="1" mname="ВАСИЛІВНА" fname="ІРІНА" lname="ГАРНА" inn="3278508288">
      <ident cchild="" sstateref="" sstate="" spdref="физическое лицо" spd="1" cgragref="Украина" cgrag="804" ceducref="" ceduc="" familyref="" family="" csexref="женщина" csex="2" bdate="1989-10-05" mname="ВАСИЛІВНА" fname="ІРІНА" lname="ГАРНА" inn="3278508288" lngref="Украинский" lng="1" vdate="2021-07-25" donor="BNK" />
      <ident cchild="" sstateref="" sstate="" spdref="физическое лицо" spd="1" cgragref="" cgrag="802" ceducref="" ceduc="" familyref="" family="" csexref="женщина" csex="2" bdate="1989-10-05" mname="ВАСИЛІВНА" fname="ІРИНА" lname="ГАРНА" inn="3278508288" lngref="Украинский" lng="1" vdate="2007-01-04" donor="BNK" />
      <doc dwdt="2002-08-01" dwho="ІВАНГОРОДСЬКИМ" dterm="" dnom="578072" dser="АМ" dtyperef="Паспорт" dtype="1" lngref="Украинский" lng="1" vdate="2021-07-10" ddonor="BNK" />
      <addr adflat="" adcorp="" adhome="7" adstreet="ТИХА" adcitytyperef="" adcitytype="" adcity="JВDКВJ" adarea="ІВАНГОРОДСКИЙ" adstate="ДНЕПРОПЕТРОВСКАЯ" adindex="23201" adcountry="UA" adtyperef="Адрес регистрации" adtype="2" lngref="Украинский" lng="1" vdate="2021-07-25" addonor="BNK" />
    </cki>
    <identdocmvds>
      <identdocmvd found="1" foundref="Знайдений" foundtitle="Паспорт АМ-578072 знайдено в списку недійсних паспортів." pser="АМ" pnom="578072" dtype="1" dtyperef="Паспорт">
        <foundsource name="MVS" found="1" foundref="Знайдений" />
        <foundsource name="DMS" found="0" foundref="Не знайдений" />
        <foundsource name="UBKI" found="0" foundref="Не знайдений" />
      </identdocmvd>
    </identdocmvds>
  </comp>
  <comp id="18" descr="Попередження від СКІ">
    <pret inn="3278508288" nonewdeal="0" nonewdealref="Ні" nonewdealcomment="" />
  </comp>
  <comp id="40" descr="Інформація із санкційного списку РНБО">
    <rnbo found="1" foundref="Знайдена інформація" subname="ГАРНА ІРІНА ВАСИЛІВНА" bdate="1989-10-05" info="Гарна Іріна Василівна, народилась 05 жовтня 1989 р., «голова департаменту зв’язків з громадськістю» незаконного збройного формування «ДНР»" sanctions="інші санкції, що відповідають принципам їх застосування, встановленим Законом (зупинення фінансових операцій) 57" sanctionsterm="Три роки" edictdate="2021-01-01" enddate="2024-01-01" url="https://zakon.rada.gov.ua/laws/file/text/64/f470000n18.pdf" typesearch="0" typesearchtext="Знайдено за ПІБ та датою народження" />
  </comp>
  <comp id="41" descr="Інформація з відкритого реєстру національних публічних діячів України">
    <pep found="0" foundref="Інформація не знайдена" subname="ГАРНА ІРІНА ВАСИЛІВНА" bdate="1989-10-05" category="" lastpost="" dateofrelease="" isur="" state="" url="" typesearch="-1" typesearchtext="Особу не знайдено за жодним параметром пошуку" />
  </comp>
  <comp id="44" descr="Верифікація номера телефону">
    <contverif phone="+380962134234" mathch="1" matchref="Так">
      <donortype donor="BNK" />
    </contverif>
  </comp>
</ubkidata>

XSD Schema request

https://secure.ubki.ua/b2/js/xsd/request12.xsd

XSD Schema response

https://secure.ubki.ua/b2/js/xsd/response12.xsd

Test URL

https://test.ubki.ua/b2_api_xml/ubki/xml

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"

  • the parameters are transferred optionally if there is a credit history for this client from your organization)

    Expand
    title body:

    {

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

    <doc>

    <ubki sessid="Сесійний ключ (отримуємо із API авторизації)">

    <req_envelope descr="Конверт запиту">

    <req_xml descr="Об'єкт запиту">

    <!-- Параметри запиту -->

    <request version="1.0" reqtype="Код шаблону (Код із дов.49): Звіт 'Ідентифікація' - 12" reqreason="Мета подання запиту (Код із дов.24)">

    <!-- Параметри, що описують критерії пошуку-->

    <i reqlng="Мова критеріїв пошуку (Код із дов.23)">

    <!-- Параметри ідентифікації суб'єкта-->

    <ident okpo="РНОКПП (ІПН) фізособи"

    lname="**Прізвище"

    fname="**Ім'я"

    mname="**По батькові"

    bdate="**Дата народження" />

    <contacts>

    <cont ctype="Тип контакту (Код із дов.10)"

    cval="Значення контакту" />

    </contacts>

    <docs>

    <doc dtype="Тип документа (Код із дов.7)"

    dser="Серія документа"

    dnom="Номер документа" />

    </docs>

    </i>

    </request>

    </req_xml>

    </req_envelope>

    </ubki>

    </doc>

    Response XML

    Expand
    titlebody:

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

    <ubkidata>

    <!-- Блок системної інформації -->

    <tech>

    <trace>

    <step name="Найменування кроку" stm="Дата штамп старту кроку" ftm="Дата штамп фінішу кроку">

    <!-- Блок trace містить метрики таймінгу кроків формування компонентів -->

    </step>

    </trace>

    <error errtype="Код помилки(Код із дов.0)" errtext="Текст помилки(Значення із дов.0)">

    </error>

    <reqinfo reqid="Вихідний ІД запиту, згенерований УБКІ">

    </reqinfo>

    <!-- Блок інформації щодо поточного стану рахунку припейд-->

    <billing>

    <balance value="Сума балансу" date="Дата" time="Час" />

    </billing>

    </tech>

    <!-- Блок ідентифікації -->

    <comp id="1" descr="Назва компоненти">

    <cki inn="РНОКПП (ІПН) СКІ/ЕДРППУ юрособи"

    lname="Прізвище/Найменування юрособи"

    fname="Ім'я"

    mname="По батькові"

    reqlng="Мова пошуку (при пошуку)/Мова ідентифікації (при передачі) (Код із дов.23)"

    reqlngref="Мова пошуку (при пошуку)/Мова ідентифікації (при передачі) (Значення із дов.23)"

    bdate="Дата народження">

    <ident donor="Джерело інформації (Значення із дов.54)"

    vdate="Дата інформації даного блоку"

    lng="Мова надання блоку (Код із дов.23)"

    lngref="Мова надання блоку (Значення із дов.23)"

    inn="РНОКПП (ІПН) СКІ"

    lname="Прізвище"

    fname="Ім'я"

    mname="По батькові"

    bdate="Дата народження"

    csex="Стать (Код із дов.1)"

    csexref="Стать(Значення із дов.1)"

    family="Сімейний стан (Код із дов.2)"

    familyref="Сімейний стан (Значення із дов.2)"

    ceduc="Освіта (Код із дов.3)"

    ceducref="Освіта (Значення із дов.3)"

    cgrag="Громадянство (Код із дов.4)"

    cgragref="Громадянство (Значення із дов.4)"

    spd="Наявність реєстрації СПД (Код із дов.5)"

    spdref="Наявність реєстрації СПД (Значення із дов.5)"

    sstate="Соціальный статус (Код із дов.6)"

    sstateref="Соціальный статус (Значення із дов.6)"

    cchild="Кількість дітей">

    <!--Даний блок може і повинен складатися з 1 .. * елементів-->

    </ident>

    <!-- Блок історії інформації місця роботи -->

    <work wdonor="Джерело інформації (Значення із дов.54)"

    vdate="Дата інформації даного блоку"

    lng="Мова надання блоку (Код із дов.23)"

    lngref="Мова надання блоку (Значення із дов.23)"

    cdolgn="Службове становище (Код із дов.8)"

    cdolgnref="Службове становище (Значення із дов.8)"

    wokpo="ЄДРПОУ місця роботи"

    wname="Назва місця роботи оригінальною мовою"

    wstag="Стаж роботи, повних років"

    wdohod="Щомісячний дохід клієнта">

    <!--Даний блок може складатися з 0 .. *-->

    </work>

    <!-- Блок історії інформації документів -->

    <doc ddonor="Джерело інформації (Значення із дов.54)"

    vdate="Дата інформації даного блоку"

    lng="Мова надання блоку (Код із дов.23)"

    lngref="Мова надання блоку (Значення із дов.23)"

    dtype="Тип документа (Код із дов.7)"

    dtyperef="Тип документа (Значення із дов.7)"

    dser="Серія документа"

    dnom="Номер документа"

    dterm="Термін дії"

    dwho="Ким виданий документ"

    dwdt="Дата видачі документа">

    <!--Даний блок повинен складатися з 1 .. * елементів і заповнений принаймні одним документом-->

    </doc>

    <!-- Блок історії інформації адрес -->

    <addr addonor="Джерело інформації (Значення із дов.54)"

    vdate="Дата інформації даного блоку"

    lng="Мова надання блоку (Код із дов.23)"

    lngref="Мова надання блоку (Значення із дов.23)"

    adtype="Тип адреси (Код із дов.9)"

    adtyperef="Тип адреси (Значення із дов.9)"

    adcountry="Країна (однорядкове резюме код з довідника ISO 3166)"

    adindex="Поштовий індекс"

    adstate="Область"

    adarea="Район"

    adcity="Населений пункт"

    adcitytype="Тип населеного пункту (Код із дов.22)"

    adcitytyperef="Тип населеного пункту (Значення із дов.22)"

    adstreet="Вулиця"

    adhome="Дім"

    adcorp="Корпус"

    adflat="Квартира"

    addrdirt="Адреса в одному рядку (буде виведений з експлуатації в наступних версіях АPІ, з 13.11.2019 поле вважається неприпустимим)">

    <!--Даний блок повинен складатися з 1 .. * елементів бути заповненим принаймні однією адресою-->

    </addr>

    </cki>

    <!-- Блок перевірки документів на дійсність -->

    <identdocmvds>

    <identdocmvd found="Знайдений? (Код із дов.27)"

    foundref="Знайдений? (Значение із дов.27)"

    foundtitle="Опис результату пошуку"

    pser="Серія паспорта"

    pnom="Номер паспорта або номер ID-картки"

    dtype="Тип документа (Код із дов.7)"

    dtyperef="Тип документа (Значення із дов.7)">

    <foundsource name="Джерело даних для перевірки (Код із дов.63)"

    found="0/1 - цифрове позначення наявності недійсного паспорту (Код із дов.27)"

    foundref="Текстове позначення наявності недійсного паспорту (Значення із дов.27)" />

    <!--Даний блок повинен складатись з 1 .. * елементів-->

    </identdocmvd>

    </identdocmvds>

    </comp>

    <!-- Попередження від СКІ -->

    <comp id="18" descr="Назва компоненти">

    <pret nonewdeal="Ознака небажання оформлювати нові кредитні продукти, статус підключення опції FREEZE: 0 - не включена, 1 - включена"

    nonewdealref="Значення ознаки небажання оформлювати нові кредитні продукти, статус підключення опції FREEZE - 0-ні (не підключена опція), 1-так (підключена опція)"

    inn="РНОКПП (ІПН) (для фіз.осіб)/ЄДРПОУ (для юр.осіб)">

    <pretension inn="РНОКПП (ІПН) (для фіз.осіб)/ЄДРПОУ (для юр.осіб)"

    crdeal="Ідентифікатор угоди (референс)"

    source="Вид оскарження (Код із дов.48)"

    sourceref="Вид оскарження (Значення із дов.48)"

    vdate="Дата створення заявки" />

    <commentcki comment="Коментар суб'єкта кредитної історії"

    vdate="Дата створення коментаря" />

    <plost pser="Серія паспорта, заявлено СКІ як загублений (крадіжка)"

    pnom="Номер паспорта, заявлено СКІ як загублений (крадіжка)"

    crdate="Дата створення заявки на втрату/крадіжку паспорта СКІ в УБКІ"

    ldate="Зазначена в заявці дата втрати/крадіжки паспорта СКІ в УБКІ" />

    <changedeal crdeal="Ідентифікатор угоди (референс)"

    changecode="Код причини коригування/видалення даних (Код із дов.62)"

    changeref="Текст причини коригування/видалення даних (Значення із дов.62)"

    vdate="Дата коригування/видалення даних" />

    </pret>

    </comp>

    <!-- Блок інформації з списку санкцій РНБО-->

    <comp id="40" descr="Інформація із списку санкцій РНБО">

    <rnbo found="Знайдений? (Код із дов.27)"

    foundref="Знайдений? (Значение із дов.27)"

    subname="Найменування суб'єкта"

    bdate="Дата народження суб'єкта"

    info="Інформація із суб'єкта"

    sanctions="Накладені санкції"

    sanctionsterm="Термін дії санкцій"

    edictdate="Дата указу президента"

    enddate="Дата закінчення обмеження"

    url="Посилання на документ-підтвердження"

    typesearch="Тип пошуку (0 - пошук по ПІБ та ДН, 1 пошук по ПІБ, -1 - нічого не знайдено)"

    typesearchtext="Текстове тлумачення типу пошуку (0 - Знайдено по ПІБ та датою народження, 1 - Знайдено по ПІБ, можливі збіги з іншими суб'єктами з однаковими даними, -1 - Суб'єкт не підпадає під санкції РНБО)" />

    <!--Даний блок повинен складатися з 1 .. * елементів -->

    </comp>

    <!-- Блок інформації з відкритого реєстру національних громадських діячів України-->

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

    },

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

    }

    },

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

    },

    "version": "1.0",

    "reqtype": "Template code (code from ref.49): 'Identification' report – 12",

    "reqreason": "Request objective (code from ref.24)"

    },

    "descr": "Request object"

    },

    "descr": "Request envelope"

    },

    "sessid": "Session key (obtained from the authorization API)"

    }

    }

    }

    Response JSON

    Expand
    titlebody:

    {

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

    },

    "billdetails": {

    "freemon": "Sign of free of charge according to the request type "Monitoring the client of the organization" (reqreason=1), code (0 - No, 1 - Yes)",

    "freemonref": "Sign of free of charge according to the request type "Monitoring the client of the organization" (reqreason=1), value (0 - No, 1 - Yes)"

    }

    }

    },

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

    },

    {

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

    "endDate": "Expiration date of restrictions",

    "sanctionsTerm": "The term of imposing the sanction",

    "sanctionsNo": "Type of imposed restrictions, numbers",

    "sanctions ": "The type of constraints imposed is Expanded",

    "address": "Location",

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

    },

    {

    "contverif": {

    "donortype": {

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

    },

    "phone": "Phone number verified",

    "mathch": "Phones verification result (code from ref.56)",

    "matchref": "Phones verification result in text format (ref.56)"

    },

    "id": "44",

    "descr": "Names of components"

    },

    {

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

    Expand
    title body:

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

    <doc>

    <ubki sessid="Session key (obtained from the authorization API)">

    <req_envelope descr="Request envelope">

    <req_xml descr="Request object">

    <!-- Request parameters -->

    <request version="1.0" reqtype="Template code (code from ref.49): 'Identification' report – 12" reqreason="Request objective (code from ref.24)">

    <!-- Parameters describing search criteria-->

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

    <!-- Subject identification parameters-->

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

    lname="**Last name"

    fname="**First name"

    mname="**Middle name"

    bdate="**Date of birth">

    </ident>

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

    </i>

    </request>

    </req_xml>

    </req_envelope>

    </ubki>

    </doc>

    Response XML

    Expand
    titlebody:

    <?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" />

    <billdetails freemon="Sign of free of charge according to the request type "Monitoring the client of the organization" (reqreason=1), code (0 - No, 1 - Yes)"

    freemonref="Sign of free of charge according to the request type "Monitoring the client of the organization" (reqreason=1), value (0 - No, 1 - Yes)

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

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

    endDate = "Expiration date of restrictions"

          sanctionsTerm = "The term of imposing the sanction"

             sanctionsNo = "Type of imposed restrictions, numbers"

            sanctions = "The type of constraints imposed is Expanded"

            address = "Location"

    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>

    <!-- Phone Number Verification part -->

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

    <contverif phone="Phone number verified"

    mathch="Phones verification result (code from ref.56)"

    matchref="Phones verification result in text format (ref.56)">

    <donortype donor="Source of information (code from ref.54)" />

    </contverif>

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

    Request JSON

    Code Block
    {
    	"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": "12",
    						"reqreason": "2"
    					}
    				}
    			},
    			"sessid": "6D7D781B1E884A6AB384481804A35EA8"
    		}
    	}
    }

    Response JSON

    Code Block
    {
    	"ubkidata": {
    		"tech": {
    			"trace": {
    				"step": {
    					"name": "build report",
    					"stm": "2022-11-25 12:15:47.585",
    					"ftm": "2022-08-25 12:15:47.807"
    				}
    			},
    			"reqinfo": {
    				"reqid": "req2#000002459637"
    			}
    		},
    		"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-02-25",
    							"donor": "BNK"
    						},
    						{
    							"cchild": "",
    							"sstateref": "",
    							"sstate": "",
    							"spdref": "natural person",
    							"spd": "1",
    							"cgragref": "",
    							"cgrag": "804",
    							"ceducref": "",
    							"ceduc": "",
    							"familyref": "",
    							"family": "",
    							"csexref": "woman",
    							"csex": "2",
    							"bdate": "1989-10-05",
    							"mname": "ВАСИЛІВНА",
    							"fname": "ІРИНА",
    							"lname": "ГАРНА",
    							"inn": "3278508288",
    							"lngref": "Ukrainian",
    							"lng": "1",
    							"vdate": "2007-08-04",
    							"donor": "BNK"
    						}
    					],
    					"doc": {
    						"dwdt": "2002-08-01",
    						"dwho": "ІВАНГОРОДСЬКИМ",
    						"dterm": "",
    						"dnom": "578072",
    						"dser": "АМ",
    						"dtyperef": "Ukrainian citizen passport",
    						"dtype": "1",
    						"lngref": "Ukrainian",
    						"lng": "1",
    						"vdate": "2022-02-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-02-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": "Ukrainian citizen passport"
    					}
    				},
    				"id": "1",
    				"descr": "Identification of the Credit History Subject (CHS)"
    			},
    			{
    				"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": "Дестабілізація ситуації в Україні",
    					"endDate": "2032-09-07",
                        "sanctionsTerm": "Десять років",
                        "sanctionsNo": "1, 2, 3, 4, 5, 6, 7, 11, 13, 14, 19, 24, 24-1",
                        "sanctions": "1 - блокування активів - тимчасове позбавлення права користуватися та розпоряджатися активами, що належать фізичній або юридичній особі, а також активами, щодо яких така особа може прямо чи опосередковано (через інших фізичних або юридичних осіб) вчиняти дії, тотожні за змістом здійсненню права розпорядження ними; 2 - обмеження торговельних операцій; 3 - обмеження, часткове чи повне припинення транзиту ресурсів, польотів та перевезень територією України; 4 - запобігання виведенню капіталів за межі України; 5 - зупинення виконання економічних та фінансових зобов’язань; 6 - анулювання або зупинення ліцензій та інших дозволів, одержання (наявність) яких є умовою для здійснення певного виду діяльності, зокрема, анулювання чи зупинення дії спеціальних дозволів на користування надрами; 7 - заборона участі у приватизації, оренді державного майна резидентами іноземної держави та особами, які прямо чи опосередковано контролюються резидентами іноземної держави або діють в їх інтересах; 11 - заборона або обмеження заходження іноземних невійськових суден та військових кораблів до територіального моря України, її внутрішніх вод, портів та повітряних суден до повітряного простору України або здійснення посадки на території України; 13 - заборона видачі дозволів, ліцензій Національного банку України на здійснення інвестицій в іноземну державу, розміщення валютних цінностей на рахунках і вкладах на території іноземної держави; 14 - припинення видачі дозволів, ліцензій на ввезення в Україну з іноземної держави чи вивезення з України валютних цінностей та обмеження видачі готівки за платіжними картками, емітованими резидентами іноземної держави; 19 - заборона передання технологій, прав на об’єкти права інтелектуальної власності; 24 - позбавлення державних нагород України, інших форм відзначення; 24-1 - заборона на набуття у власність земельних ділянок",
                        "address": "",
    					"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"
    			},
    			{
    				"contverif": {
    					"donortype": {
    						"donor": "BNK"
    					},
    					"phone": "+380962134234",
    					"mathch": "1",
    					"matchref": "Yes"
    				},
    				"id": "44",
    				"descr": "Phone number verification"
    			},
    			{
    			"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

    Code Block
    <?xml version="1.0" encoding="UTF-8"?>
    <doc>
      <ubki sessid="6D7D781B1E884A6AB384481804A35EA8">
        <req_envelope>
          <req_xml>
            <request version="1.0" reqtype="12" 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

    Code Block
    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <ubkidata>
        <tech>
            <trace>
                <step name="build report" stm="2022-11-25 12:15:47.585" ftm="2022-08-25 12:15:47.807"/>
            </trace>
            <reqinfo reqid="req2#000002459637"/>
        </tech>
        <comp id="1" descr="Identification of the Credit History Subject (CHS)">
            <cki bdate="1989-10-05" reqlngref="Ukrainian" reqlng="1" mname="ВАСИЛІВНА" fname="ІРІНА" lname="ГАРНА" inn="3278508288">
                <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-02-25" donor="BNK"/>
                <ident cchild="" sstateref="" sstate="" spdref="natural person" spd="1" cgragref="" cgrag="804" ceducref="" ceduc="" familyref="" family="" csexref="woman" csex="2" bdate="1989-10-05" mname="ВАСИЛІВНА" fname="ІРИНА" lname="ГАРНА" inn="3278508288" lngref="Ukrainian" lng="1" vdate="2007-08-04" donor="BNK"/>
                <doc dwdt="2002-08-01" dwho="ІВАНГОРОДСЬКИМ" dterm="" dnom="578072" dser="АМ" dtyperef="Ukrainian citizen passport" dtype="1" lngref="Ukrainian" lng="1" vdate="2022-02-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-02-25" addonor="BNK"/>
            </cki>
            <identdocmvds>
                <identdocmvd found="1" foundref="Found" foundtitle="Passport АМ-578072 is found in the list of invalid passports" pser="АМ" pnom="578072" dtype="1" dtyperef="Ukrainian citizen passport">
                    <foundsource name="MVS" found="1" foundref="Found" sourcedate="2022-10-16"/>
                    <foundsource name="DMS" found="0" foundref="Not found" sourcedate="2022-10-16"/>
                    <foundsource name="UBKI" found="0" foundref="Not found" sourcedate="2022-10-16"/>
                </identdocmvd>
            </identdocmvds>
        </comp>
        <comp id="18" descr="Alert">
            <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" />
        </comp>
        <comp id="40" descr="Information from sanctions lists">
          <sanctions found="1" foundRef="Знайдена інформація" subName="ГАРНА ІРІНА ВАСИЛІВНА" bDate="05.10.1989" position="Народний депутат Верховної Ради IX скликання («Опозиційна платформа — за життя»)" reason="Дестабілізація ситуації в Україні" endDate="2032-09-07" sanctionsTerm="Десять років" sanctionsNo="1, 2, 3, 4, 5, 6, 7, 11, 13, 14, 19, 24, 24-1" sanctions="1 - блокування активів - тимчасове позбавлення права користуватися та розпоряджатися активами, що належать фізичній або юридичній особі, а також активами, щодо яких така особа може прямо чи опосередковано (через інших фізичних або юридичних осіб) вчиняти дії, тотожні за змістом здійсненню права розпорядження ними; 2 - обмеження торговельних операцій; 3 - обмеження, часткове чи повне припинення транзиту ресурсів, польотів та перевезень територією України; 4 - запобігання виведенню капіталів за межі України; 5 - зупинення виконання економічних та фінансових зобов’язань; 6 - анулювання або зупинення ліцензій та інших дозволів, одержання (наявність) яких є умовою для здійснення певного виду діяльності, зокрема, анулювання чи зупинення дії спеціальних дозволів на користування надрами; 7 - заборона участі у приватизації, оренді державного майна резидентами іноземної держави та особами, які прямо чи опосередковано контролюються резидентами іноземної держави або діють в їх інтересах; 11 - заборона або обмеження заходження іноземних невійськових суден та військових кораблів до територіального моря України, її внутрішніх вод, портів та повітряних суден до повітряного простору України або здійснення посадки на території України; 13 - заборона видачі дозволів, ліцензій Національного банку України на здійснення інвестицій в іноземну державу, розміщення валютних цінностей на рахунках і вкладах на території іноземної держави; 14 - припинення видачі дозволів, ліцензій на ввезення в Україну з іноземної держави чи вивезення з України валютних цінностей та обмеження видачі готівки за платіжними картками, емітованими резидентами іноземної держави; 19 - заборона передання технологій, прав на об’єкти права інтелектуальної власності; 24 - позбавлення державних нагород України, інших форм відзначення; 24-1 - заборона на набуття у власність земельних ділянок" address="" typeSearch="0" typeSearchText="Знайдено за ПІБ та датою народження">
           <sanctionsData countryCode="EU" country="ЄВРОПЕЙСЬКИЙ СОЮЗ" sanction="0" date="" url="" />
           <sanctionsData countryCode="AU" country="АВСТРАЛІЯ" sanction="1" date="2022-05-18" url="https://www.dfat.gov.au/international-relations/security/sanctions/consolidated-list" />
           <sanctionsData countryCode="CH" country="ШВЕЙЦАРІЯ" sanction="0" date="" 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-02-02" url="https://www.president.gov.ua/documents/432021-36441" />
           <sanctionsData 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" />
           <sanctionsData countryCode="PL" country="ПОЛЬЩА" sanction="0" date="" url="" />
           <sanctionsData countryCode="US" country="СПОЛУЧЕНІ ШТАТИ АМЕРИКИ" sanction="1" date="2022-01-20" url="https://home.treasury.gov/policy-issues/financial-sanctions/recent-actions/20220120" />
           <sanctionsData 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" />
         </sanctions>
        </comp>
        <comp id="41" descr="Information from the public register of politically exposed persons of Ukraine">
            <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"/>
        </comp>
        <comp id="44" descr="Phone number verification">
            <contverif phone="+380962134234" mathch="1" matchref="Yes">
                <donortype donor="BNK"/>
            </contverif>
        </comp>
        <comp id="76" descr="Information from the Register of persons who have restricted access to gambling establishments and/or participation in gambling (using credit funds)">
            <ludomans found="0" foundref="Not found in the registry of ludomaniacs"  />
        </comp>
    </ubkidata>

    Test URL

    https://test.ubki.ua/b2_api_xml/ubki/xml

    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" (cval="+48202011010" ctype="3")

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

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

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

    • 2230428048

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

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

    <comp id="

    18

    41" descr="

    Попередження від СКІ"> опція Freezeokpo="один из примеров ниже" lname="Ivanov

    Information from the Public Register of Politically Exposed Persons of Ukraine"> 

    • bdate="1981-05-20" mname="ПЕТРОВНА" fname="

    Ivan" mname
    • МАРИЯ" lname="ИВАНЦОВА" okpo="

    Ivanovitch
    • 2972566397"

    bdate
    • dtype="

    1975-01-01
    • 1" dser="

    AH
    • СЕ" dnom="

    454241
    • 311111" cval="

    380671234567
    • +380506630641" ctype="3"

  • 2230428028

  • 2269501369

  • 2274214699

  • 2293515103

    <comp id="

    18

    72" descr="

    Попередження від СКІ

    Search by full name + inn if more than 1 person is found">

    тег <changedeal>

    • bdate="

    1991
    • 1985-03-

    30" mname="ПЕТРОВИЧ" fname="ВАДИМ" lname="НИКОЛАЕВ" okpo="3332643095" dtype="1" dser="ДО" dnom="270000" cval="+380981220000" ctype="3"<comp id="40" descr="Інформація з списку санкцій РНБО
    • 20" mname="НИКИФОРОВНА" fname="АННА" lname="ЯРЦЕВА"

    <comp id="76" descr="Information from the Register of persons who have restricted access to gambling establishments and/or participation in gambling (using credit funds)">

    • bdate="

    1989
    • 1957-10-

    05
    • 19" mname="

    ВАСИЛІВНА
    • ІГОРЕВНА" fname="

    ІРІНА
    • АННА" lname="

    ГАРНА
    • РИБАЧКА" okpo="

    3278508288
    • 2111118724" dtype="1" dser="

    АМ
    • ВВ" dnom="

    578072
    • 142228" cval="+

    380962134234
    • 380662134234" ctype="3"

    <comp id="41" descr="Інформація з відкритого реєстру національних громадських діячів України">,

    • bdate="

    1981
    • 1991-

    05
    • 04-

    20
    • 06" mname="

    ПЕТРОВНА
    • ВОЛОДИМИРОВИЧ" fname="

    МАРИЯ
    • ВОЛОДИМИР" lname="

    ИВАНЦОВА
    • ТКАЧУК" okpo="

    2972566397
    • 3333312110" dtype="1" dser="

    СЕ
    • ДД" dnom="

    311111
    • 222222" cval="+

    380506630641
    • 380732144444" ctype="3"