Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »


Identification of the individual.


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

  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)/EDRPOU (for legal entities)" 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

 body:

<?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="Components name">

<cki inn="INN of the subject of credit history" lname="Surname/Name of the legal entity" fname="Name" mname="Father’s name" 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)" bdate="Date of Birth">

<ident donor="A source of information (code from ref. 54)" vdate="Date of information of this block" lng="Block representation language (Code from ref.23)" lngref="Block representation language (Meaning of ref.23)" inn="INN SKI" lname="Surname" fname="Name" mname="Father’s name" bdate="Date of Birth" csex="Sex (Code from ref.1)" csexref="Sex (Meaning from ref.1)" family="Marital status (Code from ref.2)" familyref="Marital status (Meaning from ref.2)" ceduc="Education (Code from ref.3)" ceducref="Education (Meaning from ref.3)" cgrag="Citizenship (Code from ref.4)" cgragref="Citizenship (Meaning from ref.4)" spd="Availability of SPD registration (Code from ref.5)" spdref="Availability of SPD registration (meaning from ref.5)" sstate="Social status (Code from ref.6)" sstateref="Social status (Meaning from ref.6)" cchild="Number of children">

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

</ident>

<!-- Block of the Information History about place of work -->

<work wdonor="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)" cdolgn="Occupational status (Code from ref.8)" cdolgnref="Occupational status (Meaning from ref.8)" wokpo="EGRPOU of the place of work" wname="Name of the place of work in the basic language" wstag="Work experience, full years" wdohod="Monthly customer income">

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

</work>

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

<doc ddonor="A source of information (code from ref. 54)" vdate="Date of information of this block" lng="Block representation language (Code from ref.23)" lngref="Block representation language (Meaning from ref.23)" dtype="Document type (Code from ref.7)" dtyperef="Document type (Meaning from ref.7)" dser="Document series" dnom="Document Number" dterm="Validity term" dwho="Document is issued by" dwdt="Date of issue of the document">

<!--This block has to consist of 1 .. * elements and is filled with at least by one document-->

</doc>

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

<addr addonor="A source of information (code from ref. 54)" vdate="Date of information of this block" lng="Block representation language (Code from ref.23)" lngref="Block representation language (Meaning from ref.23)" adtype="Address type (Code from ref.9)" adtyperef="Address type (Meaning from ref.9)" adcountry="country" adindex="ZIP code" adstate="Region" adarea="District" adcity="Settlement" adcitytype="Settlement type (Code from ref.22)" adcitytyperef="Settlement type (Meaning from ref.22)" adstreet="Street" adhome="House" adcorp="Block" adflat="Apartment" addrdirt="Address in one line (in case if the address is not decomposed in the old data) as agreed with the Ukrainian Bureau of the Credit History">

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

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

</identdocmvd>

</identdocmvds>

</comp>

<!-- Client alert -->

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

<pret nonewdeal="Indication of reluctance to apply for new credit products, status of the FREEZE option activation: 0 – not activated, 1 – activated" nonewdealref=" Value of the indication of reluctance to apply for new credit products, status of the FREEZE option activation: 0 – no (option not activated), 1 – yes (option activated)" inn="TIN (for individuals)/EDRPOU (for legal entities)">

<pretension inn="TIN (for individuals)/EDRPOU (for legal entities)" crdeal="Transaction ID (reference)" source="Type of dispute (code from ref.48)" sourceref="Type of dispute (value from ref.48)" vdate="Application creation date" />

<commentcki comment="Comment of the subject of the credit history" vdate="Comment creation date" />

<plost pser="Series of passport declared lost (stolen) by the credit history subject" pnom="Passport number declared lost (stolen) by credit history subject" crdate="Date of submitting the application for loss/theft of the credit history subject’s passport in UBKI" ldate="Date of loss/theft of the credit history subject’s passport specified in the application to UBKI" />

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

<!-- "Information from the National Security and Defense Council’s sanctions list" part-->

<comp id="40" descr="Information from the National Security and Defense Council’s sanction list">

<rnbo found="0 – not located, 1 – located " foundref="not located/located" subname="Subject’s name" bdate="Subject’s date of birth" info="Information from the subject" sanctions="Sanctions imposed" sanctionsterm="Duration of sanctions" edictdate="Date of the President’s decree" enddate="Restriction end date" url="Link to the document – confirmation" typesearch="Search type (0 - search by full name and date of birth, 1 - search by full name, -1 - nothing found) - for individuals" typesearchtext="Text interpretation of the type of search (0 - Found by full name and date of birth, 1 - Found by full name, matches with other subjects with the same data are possible, -1 - The subject is not subject to NSDC sanctions)" />

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

</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 and must contain 1..* items-->

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

</ubkidata>

Example

Request

<?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 version="1.0" encoding="UTF-8" standalone="yes"?>
<ubkidata>
    <tech>
        <trace>
            <step name="build report" stm="2022-08-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="802" 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="Passport" dtype="1" lngref="Ukrainian" lng="1" vdate="2022-02-10" 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="Passport">
                <foundsource name="MVS" found="1" foundref="Found"/>
                <foundsource name="DMS" found="0" foundref="Not found"/>
                <foundsource name="UBKI" found="0" foundref="Not found"/>
            </identdocmvd>
        </identdocmvds>
    </comp>
    <comp id="18" descr="Client alert">
        <pret inn="3278508288" nonewdeal="0" nonewdealref="No" nonewdealcomment=""/>
    </comp>
    <comp id="40" descr="Information from the NSDC sanctions list">
        <rnbo found="1" foundref="Found information" subname="ГАРНА ІРІНА ВАСИЛІВНА" bdate="1989-10-05" info="" sanctions="інші санкції, що відповідають принципам їх застосування, встановленим Законом (зупинення фінансових операцій) 57" sanctionsterm="Три роки" edictdate="2021-01-01" enddate="2024-01-01" url="https://zakon.rada.gov.ua/laws/file/text/64/f475706n18.pdf" typesearch="0" typesearchtext="Found by name and date of birth"/>
    </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>
</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"

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

<comp id="18" descr="Попередження від СКІ"> опція Freeze

okpo="один из примеров ниже" 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="Попередження від СКІ"> тег <changedeal>

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

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

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

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

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

  • No labels