Versions Compared

Old Version 29

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

Saved on

compared with

New Version Current

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"

}

},

"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

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": "802804",
							"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": "Дестабілізація ситуації в Україні",
					"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)"
		}
	}
}

...

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="802804" 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="Found information" subName="ГАРНА ІРІНА ВАСИЛІВНА" bDate="05.10.1989" position="Народний депутат Верховної Ради IX скликання («Опозиційна платформа — за життя»)" reason="Дестабілізація ситуації в Україні" typeSearch="0" typeSearchText="Found by name and date of birth">
       <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"

  • 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="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="41" descr="Information from the Public Register of Politically Exposed Persons of Ukraine"> 

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

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

  • bdate="1985-03-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="1957-10-19" mname="ІГОРЕВНА" fname="АННА" lname="РИБАЧКА" okpo="2111118724" dtype="1" dser="ВВ" dnom="142228" cval="+380662134234" ctype="3"

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

...