Versions Compared

Old Version 33

changes.mady.by.user Оксана Нечепоренко

Saved on

compared with

New Version 34

changes.mady.by.user Оксана Нечепоренко

Saved on

Key

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

...

Http Method

POST

Request URL

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

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

Expand
title body:

{

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

}

},

"mvd": {

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

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

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

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

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

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

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

},

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

},

"version": "1.0",

"reqtype": "Template code (code from ref.49): 'Credit Score' Report – 11",

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

},

"descr": "Request object"

},

"descr": "Request envelope"

},

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

}

}

}

...

Response JSON

Code Block
{
  "ubkidata": {
    "tech": {
      "trace": {
        "step": {
          "name": "build report",
          "stm": "2022-08-25 11:50:06.455",
          "ftm": "2022-08-25 11:50:06.685"
        }
      },
      "reqinfo": {
        "reqid": "req2#000002459578"
      }
    },
    "comp": [
      {
        "cki": {
          "ident": {
            "cchild": "",
            "sstateref": "",
            "sstate": "",
            "spdref": "natural person",
            "spd": "1",
            "cgragref": "",
            "cgrag": "802804",
            "ceducref": "",
            "ceduc": "",
            "familyref": "",
            "family": "",
            "csexref": "woman",
            "csex": "2",
            "bdate": "1957-10-19",
            "mname": "ІГОРЕВНА",
            "fname": "АННА",
            "lname": "РИБАЧКА",
            "inn": "2111118724",
            "lngref": "Russian",
            "lng": "2",
            "vdate": "2022-02-06",
            "donor": "BNK"
          },
          "work": {
            "wdohod": "",
            "wstag": "",
            "wname": "ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ 'УКРАЇНСЬКА КОМПАНІЯ 'О'",
            "wokpo": "34745377",
            "cdolgnref": "Worker/specialist/performer",
            "cdolgn": "3",
            "lngref": "Ukrainian",
            "lng": "1",
            "vdate": "2021-11-07",
            "wdonor": "BNK"
          },
          "doc": {
            "dwdt": "2004-03-10",
            "dwho": "ХЕРСОНСКИМ ГО УМВД",
            "dterm": "",
            "dnom": "142228",
            "dser": "ВВ",
            "dtyperef": "Ukrainian citizen passport",
            "dtype": "1",
            "lngref": "Ukrainian",
            "lng": "1",
            "vdate": "2021-08-01",
            "eddr_number": "19571019-00027",
            "ddonor": "BNK"
          },
          "addr": {
            "adflat": "81",
            "adcorp": "",
            "adhome": "11",
            "adstreet": "ВУЛ.ЕЖЕЛЕ",
            "adcitytyperef": "",
            "adcitytype": "",
            "adcity": "М.ХЕРСОН",
            "adarea": "",
            "adstate": "ХЕРСОНСЬКА",
            "adindex": "10000",
            "adcountry": "UA",
            "adtyperef": "Address of registration",
            "adtype": "2",
            "lngref": "Ukrainian",
            "lng": "1",
            "vdate": "1900-01-01",
            "addonor": "BNK"
          },
          "bdate": "1957-10-19",
          "reqlngref": "Russian",
          "reqlng": "2",
          "mname": "ІГОРЕВНА",
          "fname": "АННА",
          "lname": "РИБАЧКА",
          "inn": "2111118724"
        },
        "identdocmvds": {
          "identdocmvd": {
            "foundsource": [
              {
                "name": "MVS",
                "found": "0",
                "foundref": "Not 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": "0",
            "foundref": "Not found",
            "foundtitle": "Passport ВВ-142228 is not found in the list of invalid passports",
            "pser": "ВВ",
            "pnom": "142228",
            "dtype": "1",
            "dtyperef": "Ukrainian citizen passport"
          }
        },
        "id": "1",
        "descr": "Identification of the Credit History Subject (CHS)"
      },
      {
        "credres": [
          {
            "org": "OWN",
            "reqreasonref": "Credit request",
            "reqreason": "2",
            "resultref": "Report provided successfully",
            "result": "1",
            "reqid": "req2#000002459450",
            "inn": "2111118724",
            "redate": "2022-08-25",
            "retime": "10:29:31",
            "typereport": "2",
			"typereportref": "Credit history"
          },
          {
            "org": "BNK",
            "reqreasonref": "Credit request",
            "reqreason": "2",
            "resultref": "Report provided successfully",
            "result": "1",
            "reqid": "req2#000002459275",
            "inn": "2111118724",
            "redate": "2022-08-25",
            "retime": "01:14:03",
            "typereport": "2",
			"typereportref": "Credit history"
          },
          {
            "org": "BNK",
            "reqreasonref": "Credit request",
            "reqreason": "2",
            "resultref": "Report provided successfully",
            "result": "1",
            "reqid": "req2#000002458722",
            "inn": "2111118724",
            "redate": "2022-08-24",
            "retime": "01:14:04",
            "typereport": "2",
			"typereportref": "Credit history"
          },
          {
            "org": "OWN",
            "reqreasonref": "Credit request",
            "reqreason": "2",
            "resultref": "Report provided successfully",
            "result": "1",
            "reqid": "req2#000002458406",
            "inn": "2111118724",
            "redate": "2022-08-23",
            "retime": "14:07:31",
            "typereport": "2",
			"typereportref": "Credit history"
          },
          {
            "org": "FIN",
            "reqreasonref": "Monitoring (does not affect the credit rating)",
            "reqreason": "1",
            "resultref": "Report provided successfully",
            "result": "1",
            "reqid": "req2#000001512839",
            "inn": "2111118724",
            "redate": "2021-04-19",
            "retime": "13:46:50",
            "typereport": "2",
			"typereportref": "Credit history"
          },
          {
            "org": "BNK",
            "reqreasonref": "Monitoring (does not affect the credit rating)",
            "reqreason": "1",
            "resultref": "Report provided successfully",
            "result": "1",
            "reqid": "req2#000001469755",
            "inn": "2111118724",
            "redate": "2021-01-29",
            "retime": "18:09:47",
            "typereport": "2",
			"typereportref": "Credit history"
          }
        ],
        "reestrtime": {
          "hr": "0",
          "da": "2",
          "wk": "10",
          "mn": "31",
          "qw": "77",
          "ye": "379",
          "yu": "32"
        },
        "id": "4",
        "descr": "Inquiries registry"
      },
      {
        "id": "5",
        "descr": "Checking according to the databases of the invalid documents"
      },
      {
        "moncredres": [
          {
            "org": "BNK",
            "resultref": "Report provided successfully",
            "result": "1",
            "monid": "MFB50ED6A7683C1E8",
            "inn": "2111118724",
            "startdate": "2022-02-10",
            "enddate": "2022-04-25"
          },
          {
            "org": "FIN",
            "resultref": "Report provided successfully",
            "result": "1",
            "monid": "ME926E3B7CAD27B78",
            "inn": "2111118724",
            "startdate": "2021-04-02",
            "enddate": "2021-04-19"
          }
        ],
        "id": "6",
        "descr": "Monitoring (does not affect credit rating)"
      },
      {
        "urating": {
          "dinfo": {
            "all": "104",
            "open": "25",
            "opentext": "",
            "close": "79",
            "expyear": "Так",
            "maxnowexp": "40071.0 UAH",
            "datelastupdate": "2021-08-18 00:00:00",
            "expall": "0",
            "expnow": "0",
            "reqs12m": "10",
            "smexpnow": "Немає",
            "smalldebt": "8999.00",
            "vpall": "2",
            "vpopen": "1"
          },
          "comments": {
            "comment": {
              "id": "1",
              "text": "A very low rate may indicate that the borrower is uncharitable."
            },
            "count": "1"
          },
          "pfactors": {
            "count": "0",
            "text": "Positive factors"
          },
          "nfactors": {
            "comment": {
              "text": "You have significant overdue debt that automatically assigns a score of 0 (default)."
            },
            "count": "1",
            "text": "Negative factors"
          },
          "inn": "2111118724",
          "lname": "Рибачка",
          "fname": "Анна",
          "mname": "Игоревна",
          "bdate": "1957-10-19",
          "score": "0",
          "scorelast": "0",
          "scoredate": "2021-08-18",
          "scoredatelast": "2021-08-18",
          "scorelevel": "0",
          "score3": "NA"
        },
        "id": "8",
        "descr": "Credit rating of UBKI"
      },
      {
        "pret": {
          "inn": "2111118724",
          "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"
      },
      {
        "scoremfo": {
          "attributes": {
            "closemfo": "0",
            "closenoexp": "0",
            "cntreqsweek": "10",
            "maxnowdaymfo": "0",
            "openmfo": "0",
            "soldmfo": "0",
            "dlamtcurmfo": "0.00",
            "sumnowexpmfo": "0.00"
          },
          "inn": "2111118724",
          "lname": "РИБАЧКА",
          "fname": "АННА",
          "mname": "ІГОРЕВНА",
          "bdate": "1957-10-19",
          "scoremfo": "95",
          "scoremfodate": "2022-08-25"
        },
        "id": "23",
        "descr": "Scoring for microfinance companies"
      },
      {
        "id": "54",
        "descr": "Bankruptcy information",
        "bankruptcyinfo": {
          "found": "1",
          "foundref": "Знайдена інформація про банкрутство",
          "bankruptcy": [
            {
              "subname": "ГАРНА ІРІНА ВАСИЛІВНА",
              "subcode": "3278508288",
              "eventtype": "Інформація про поновлення справи про банкрутство",
              "eventclaimer": "Вищий господарський суд України (vgsu.arbitr.gov.ua)",
              "eventcourtcase": "910/3551/21",
              "eventdate": "2021-04-14"
            },
            {
              "subname": "ГАРНА ІРІНА ВАСИЛІВНА",
              "subcode": "3278508288",
              "eventtype": "Інформація про порушення справи про банкрутство",
              "eventclaimer": "Вищий господарський суд України (vgsu.arbitr.gov.ua)",
              "eventcourtcase": "910/3551/21",
              "eventdate": "2021-10-06"
            }
          ]
        }
      }
    ]
  }
}

...

Response XML

Code Block
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ubkidata>
    <tech>
        <trace>
            <step name="build report" stm="2022-08-25 11:50:06.455" ftm="2022-08-25 11:50:06.685"/>
        </trace>
        <reqinfo reqid="req2#000002459578"/>
    </tech>
    <comp id="1" descr="Identification of the Credit History Subject (CHS)">
        <cki bdate="1957-10-19" reqlngref="Russian" reqlng="2" mname="ІГОРЕВНА" fname="АННА" lname="РИБАЧКА" inn="2111118724">
            <ident cchild="" sstateref="" sstate="" spdref="natural person" spd="1" cgragref="" cgrag="802804" ceducref="" ceduc="" familyref="" family="" csexref="woman" csex="2" bdate="1957-10-19" mname="ІГОРЕВНА" fname="АННА" lname="РИБАЧКА" inn="2111118724" lngref="Russian" lng="2" vdate="2022-02-06" donor="BNK"/>
            <work wdohod="" wstag="" wname="ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ 'УКРАЇНСЬКА КОМПАНІЯ 'О'" wokpo="34745377" cdolgnref="Worker/specialist/performer" cdolgn="3" lngref="Ukrainian" lng="1" vdate="2021-11-07" wdonor="BNK"/>
            <doc dwdt="2004-03-10" dwho="ХЕРСОНСКИМ ГО УМВД" dterm="" dnom="142228" dser="ВВ" dtyperef="Ukrainian citizen passport" dtype="1" lngref="Ukrainian" lng="1" vdate="2021-08-01" eddr_number="19571019-00027" ddonor="BNK"/>
            <addr adflat="81" adcorp="" adhome="11" adstreet="ВУЛ.ЕЖЕЛЕ" adcitytyperef="" adcitytype="" adcity="М.ХЕРСОН" adarea="" adstate="ХЕРСОНСЬКА" adindex="10000" adcountry="UA" adtyperef="Address of registration" adtype="2" lngref="Ukrainian" lng="1" vdate="1900-01-01" addonor="BNK"/>
        </cki>
        <identdocmvds>
            <identdocmvd found="0" foundref="Not found" foundtitle="Passport ВВ-142228 is not found in the list of invalid passports" pser="ВВ" pnom="142228" dtype="1" dtyperef="Ukrainian citizen passport">
                <foundsource name="MVS" found="0" foundref="Not 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="4" descr="Inquiries registry">
        <credres org="OWN" reqreasonref="Credit request" reqreason="2" resultref="Report provided successfully" result="1" reqid="req2#000002459450" inn="2111118724" redate="2022-08-25" retime="10:29:31" typereport="2" typereportref="Credit history"/>
        <credres org="BNK" reqreasonref="Credit request" reqreason="2" resultref="Report provided successfully" result="1" reqid="req2#000002459275" inn="2111118724" redate="2022-08-25" retime="01:14:03" typereport="2" typereportref="Credit history"/>
        <credres org="BNK" reqreasonref="Credit request" reqreason="2" resultref="Report provided successfully" result="1" reqid="req2#000002458722" inn="2111118724" redate="2022-08-24" retime="01:14:04" typereport="2" typereportref="Credit history"/>
        <credres org="OWN" reqreasonref="Credit request" reqreason="2" resultref="Report provided successfully" result="1" reqid="req2#000002458406" inn="2111118724" redate="2022-08-23" retime="14:07:31" typereport="2" typereportref="Credit history"/>
        <credres org="FIN" reqreasonref="Monitoring (does not affect the credit rating)" reqreason="1" resultref="Report provided successfully" result="1" reqid="req2#000001512839" inn="2111118724" redate="2021-04-19" retime="13:46:50"/>
        <credres org="BNK" reqreasonref="Monitoring (does not affect the credit rating)" reqreason="1" resultref="Report provided successfully" result="1" reqid="req2#000001469755" inn="2111118724" redate="2021-01-29" retime="18:09:47"/>
        <reestrtime hr="0" da="2" wk="10" mn="31" qw="77" ye="379" yu="32"/>
    </comp>
    <comp id="5" descr="Checking according to the databases of the invalid documents"/>
    <comp id="6" descr="Monitoring (does not affect credit rating)">
        <moncredres org="BNK" resultref="Report provided successfully" result="1" monid="MFB50ED6A7683C1E8" inn="2111118724" startdate="2022-02-10" enddate="2022-04-25"/>
        <moncredres org="FIN" resultref="Report provided successfully" result="1" monid="ME926E3B7CAD27B78" inn="2111118724" startdate="2021-04-02" enddate="2021-04-19"/>
         </comp>
    <comp id="8" descr="Credit rating of UBKI">
        <urating inn="2111118724" lname="Рибачка" fname="Анна" mname="Игоревна" bdate="1957-10-19" score="0" scorelast="0" scoredate="2021-08-18" scoredatelast="2021-08-18" scorelevel="0" score3="NA">
            <dinfo all="104" open="25" opentext="" close="79" expyear="Так" maxnowexp="40071.0 UAH" datelastupdate="2021-08-18 00:00:00" expall="0" expnow="0" reqs12m="10" smexpnow="Немає" smalldebt="8999.00" vpall="2" vpopen="1" />
            <comments count="1">
               <comment id="1" text="A very low rate may indicate that the borrower is uncharitable."/>
             </comments>
             <pfactors count="0" text="Positive factors"/>
             <nfactors count="1" text="Negative factors">
                 <comment text="You have significant overdue debt that automatically assigns a score of 0 (default)."/>
            </nfactors>
        </urating>
    </comp>
    <comp id="18" descr="Alert">
        <pret inn="2111118724" 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="23" descr="Scoring for microfinance companies">
        <scoremfo inn="2111118724" lname="РИБАЧКА" fname="АННА" mname="ІГОРЕВНА" bdate="1957-10-19" scoremfo="95" scoremfodate="2022-08-25">
            <attributes closemfo="0" closenoexp="0" cntreqsweek="10" maxnowdaymfo="0" openmfo="0" soldmfo="0" dlamtcurmfo="0.00" sumnowexpmfo="0.00"/>
        </scoremfo>
    </comp>
    <comp id="54" descr="Bankruptcy information">
        <bankruptcyinfo found="1" foundref="Знайдена інформація про банкрутство">
            <bankruptcy subname="ГАРНА ІРІНА ВАСИЛІВНА" subcode="3278508288" eventtype="Інформація про поновлення справи про банкрутство" eventclaimer="Вищий господарський суд України (vgsu.arbitr.gov.ua)" eventcourtcase="910/3551/21" eventdate="2021-04-14"/>
            <bankruptcy subname="ГАРНА ІРІНА ВАСИЛІВНА" subcode="3278508288" eventtype="Інформація про порушення справи про банкрутство" eventclaimer="Вищий господарський суд України (vgsu.arbitr.gov.ua)" eventcourtcase="910/3551/21" eventdate="2021-10-06"/>
        </bankruptcyinfo>
    </comp>
</ubkidata>

...

Test URL

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

Test data

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

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

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

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

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

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

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

  • Credit Score 446 - bdate="1989-10-05" mname="ВАСИЛІВНА" fname="ІРІНА" lname="ГАРНА" okpo="3278508288" dtype="1" dser="АМ" dnom="578072" cval="+380962134234" 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"

  • 22304280282230428048

  • 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="54" descr="Information bankruptcy"> 

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

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

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

...