Versions Compared

Key

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

...

Info

The report contains the following components:

Request JSON
( **parameters are passed optionally)

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"

},

"mvd": {

"dtype": "Sought-for document type (code 1, 3, 17 from дов.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): 'Verification ' – 21",

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

},

"descr": "Request object"

},

"descr": "Request envelope"

},

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

}

}

}

</error>

<reqinfo reqid="Outgoing request ID generated by UBKI">

</reqinfo>

<billing>

<!-- Information about the current status of the prepaid account part-->

<balance value="Total assets" date="Date" time="Time" />

</billing>

</tech>

<!-- Search for canceled documents -->

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

<mvd found="Is it found? (The code from ref.27)"

foundref="Is it found? (Meaning from ref.27)"

foundtitle="Description of the search result"

pser="Series of the required passport"

pnom="Number of the required passport or number of ID-card"

plname="Surname of the required passport"

pfname="Name of the required passport"

pmname="Father’s name of the required passport"

pbdate="Date of birth of the required passport"

status="Reason for cancellation (Only for data from DATA.GOV.UA)"

stdate="Cancellation Date (Only for data from DATA.GOV.UA)">

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

</mvd>

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

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"

}

}

},

"comp": [

{

"mvd": {

"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": "Is it found? (The code from ref.27)",

"foundref": "Is it found? (Meaning from ref.27)",

"foundtitle": "Description of the search result",

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

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

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

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

"pmname": "Father’s name of the required passport",

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

"status": "Reason for cancellation (Only for data from DATA.GOV.UA)",

"stdate": "Cancellation Date (Only for data from DATA.GOV.UA)"

},

"id": "5",

"descr": "Components name"

},

{

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

},

"idfcert": "18",{

"descrinn": "Components nameTIN" },

{

"passportverifcert": { "coincide": "0-no match, 1-match"Availability of a certificate from the UBCH (code from ref. 56) - 0 - no (no registered certificate), 1 - yes (registered certificate) ",

"coinciderefcertref": "Yes/NoAvailability of a certificate from the UBCH (value from ref. 56)",

"existidentcertid": "Indication of the presence of identification data at the client (0-present, 1-missing)",

"existidentref": "Text indication of the presence of client identification data (Yes/No)",

"lname": "Last name",

"fname": "First name",

"mname": "Middle name",

"bdate": "Date of birth",

"ser": "Sought-for passport series",

"nom": "Number of the sought-for passport or ID card"

},

"id": "22",

"descr": "Names of components"

},

{

"person": {

"bdate": "Date of birth",

"lngref": "Search/transfer language (ref. 23)",

"lng": "Part presentation language, value (ref. 23)",

"mname": "Middle "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"

},

{

"passportverif": {

"coincide": "0-no match, 1-match",

"coincideref": "Yes/No",

"existident": "Indication of the presence of identification data at the client (0-present, 1-missing)",

"existidentref": "Text indication of the presence of client identification data (Yes/No)",

"lname": "Last name",

"fname": "First name",

"lnamemname": "Last nameMiddle name",

"bdate": "Date of birth",

"ser": "Sought-for passport series",

"inn nom": "TIN Number of the credit history subject",sought-for passport or ID card"

},

"id": "7222",

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

}

]

}

}

Request XML
( **parameters are passed optionally)

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): 'Verification ' – 21" 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>

<!-- For the requests to search for canceled documents -->

<mvd dtype= "Sought-for document type (code 1, 3, 17 from дов.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">

</mvd>

</i>

</request>

</req_xml>

</req_envelope>

</ubki>

</doc>

Response XML

Expand
titlebody:

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

<ubkidata>

<tech>

<!-- System information part -->

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

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

}

]

}

}

Request XML
( **parameters are passed optionally)

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): 'Verification ' – 21" 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>

<!-- For the requests to search for canceled documents -->

<mvd dtype= "Sought-for document type (code 1, 3, 17 from дов.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">

</mvd>

</i>

</request>

</req_xml>

</req_envelope>

</ubki>

</doc>

Response XML

Expand
titlebody:

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

<ubkidata>

<tech>

<!-- System information part -->

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

<billing>

<!-- Information about the current status of the prepaid account part-->

<balance value="Total assets" date="Date" time="Time" />

</billing>

</tech>

<!-- Search for canceled documents -->

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

<mvd found="Is it found? (The code from ref.27)"

foundref="Is it found? (Meaning from ref.27)"

foundtitle="Description of the search result"

pser="Series of the required passport"

pnom="Number of the required passport or number of ID-card"

plname="Surname of the required passport"

pfname="Name of the required passport"

pmname="Father’s name of the required passport"

pbdate="Date of birth of the required passport"

status="Reason for cancellation (Only for data from DATA.GOV.UA)"

stdate="Cancellation Date (Only for data from DATA.GOV.UA)">

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

</mvd>

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

</comp>

<!-- Subject Verification by Full Name+DOB+Passport part -->

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

<passportverif coincide="0-no match, 1-match"

coincideref="Yes/No"

existident="Indication of the presence of identification data at the client (0-present, 1-missing)"

existidentref="Text indication of the presence of client identification data (Yes/No)"

lname="Last name"

fname="First name"

mname="Middle name"

bdate="Date of birth"

ser="Sought-for passport series"

nom="Number of the sought-for passport or ID card<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>

<!-- 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)Subject Verification by Full Name+DOB+Passport part -->

<comp id="7222" descr="Search by full name + inn if more than 1 person is foundNames 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" />

</comp>

</ubkidata>

Example

Request JSON

Code Block{ "doc": { "ubki": { "req_envelope": { "req_xml": { "request": {

<passportverif coincide="0-no match, 1-match"

coincideref="Yes/No"

existident="Indication of the presence of identification data at the client (0-present, 1-missing)"

existidentref="Text indication of the presence of client identification data (Yes/No)"

lname="Last name"

fname="First name"

mname="Middle name"

bdate="Date of birth"

ser="Sought-for passport series"

nom="Number of the sought-for passport or ID card" />

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

</ubkidata>

Example

Request JSON

Code Block
{
	"doc": {
		"ubki": {
			"req_envelope": {
				"req_xml": {
					"request": {
						"i": {
							"ident": {
								"bdate": "1989-10-05",
								"mname": "ВАСИЛІВНА",
								"fname": "ІРІНА",
								"lname": "ГАРНА",
								"okpo": "3278508288"
							},
							"mvd": {
								"idtype": {"1",
								"identpser": {"АМ",
								"bdatepnom": "1989-10-05578072",
								"mnameplname": "ВАСИЛІВНАГАРНА",
								"fnamepfname": "ІРІНА",
								"lnamepmname": "ГАРНАВАСИЛІВНА",
								"okpopbdate": "32785082881989-10-05"
							},
							"mvdreqlng": {
"4"
						},
						"dtypeversion": "1.0",
								"pserreqtype": "АМ21",
								"pnomreqreason": "578072"2"
					}
				}
			},
			"sessid": "F936E3872D7740D7910BB32C933318B3"
				}
	}
}

Response JSON

Code Block
{
	"
plname
ubkidata": {
		"
ГАРНА
tech"
,
: {
			
"
pfname
trace": 
"ІРІНА",
{
				
"
pmname
step": 
"ВАСИЛІВНА",
{
					
"
pbdate
name": "
1989-10-05" }
build report",
					
"
reqlng
stm": "
4" },
2022-11-26 09:26:44.35",
					"
version
ftm": "
1.0",
2022-08-26 09:26:44.44"
				}
			},
			"
reqtype
reqinfo": 
"21",
{
				
"
reqreason
reqid": "
2" }
req2#000002460341"
			
}
		
},
		
"
sessid
comp": 
"F936E3872D7740D7910BB32C933318B3"
[
		
}
	
} }

Response JSON

Code Block
{
				"ubkidatamvd": {
					"techfoundsource":  [
						{
			"trace": {
				"stepname": {"UBKI",
							"namefound": "build report0",
							"stmfoundref": "2022-11-26 09:26:44.35Not found",
							"ftmsourcedate": "2022-08-26 09:26:44.4410-16"
						},
					},	{
							"reqinfoname": {"MVS",
							"reqidfound": "req2#0000024603411",
			}
		},
		"compfoundref": ["Found",
			{
				"mvdsourcedate": {"2022-10-16"
					"foundsource": [
	},
						{
							"name": "UBKIDMS",
							"found": "0",
							"foundref": "Not found",
							"sourcedate": "2022-10-16"
						},
					],
			{
		"found": "1",
					"namefoundref": "MVSFound",
							"found": "1""foundtitle": "Passport АМ-578072 is found in the list of invalid passports.",
							"foundrefpser": "FoundАМ",
							"sourcedatepnom": "2022-10-16"
						},
						{
		578072",
					"nameplname": "DMSHARNA",
							"foundpfname": "0IRINA",
							"foundrefpmname": "Not foundVASYLIVNA",
							"sourcedatepbdate": "20221989-10-16"
						}
					]05",
					"founddtype": "1",
					"foundrefdtyperef": "FoundPassport",
					"foundtitle": "Passport АМ-578072 is found in the list of invalid passports."},
					"pserid": "АМ5",
					"pnomdescr": "578072"Search for canceled documents"
			},
			{
				"plnamepret": "HARNA",{
					"pfnameinn": "IRINA3278508288",
					"pmnamenonewdeal": "VASYLIVNA0",
					"pbdatenonewdealref": "1989-10-05No",
					"dtypenonewdealcomment": "1",
					"dtypereffreezedate": "Passport"
				},
				"idfcert": "5",{
					"descrinn": "Search for canceled documents"3278508288",
			}		"cert": "0",
			{
				"pretcertref": {"No",
					"inncertid": "3278508288",
					"nonewdealcerturl": "0"
				},
				"maybegone": {
					"nonewdealrefinn": "No3278508288",
					"nonewdealcommentvdate": " "2022-12-01",
					"freezedatedldonor": "BNK"
				},
				"id": "18",
				"descr": "Alert"
			},
			{
				"passportverif": {
					"coincide": "1",
					"coincideref": "Yes",
					"existident": "1",
					"existidentref": "Yes",
					"mname": "ВАСИЛІВНА",
					"fname": "ІРІНА",
					"lname": "ГАРНА",
					"bdate": "1989-10-05",
					"ser": "АМ",
					"nom": "578072"
				},
				"id": "22",
				"descr": "Result of verification of Full Name-Passport-DOB"
			}
		]
	}
}

...

Response XML

Code Block
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ubkidata>
    <tech>
        <trace>
            <step name="build report" stm="2022-11-26 09:26:44.35" ftm="2022-08-26 09:26:44.44"/>
        </trace>
        <reqinfo reqid="req2#000002460341"/>
    </tech>
    <comp id="5" descr="Search for canceled documents">
        <mvd found="1" foundref="Found" foundtitle="Passport АМ-578072 is found in the list of invalid passports." pser="АМ" pnom="578072" plname="HARNA" pfname="IRINA" pmname="VASYLIVNA" pbdate="1989-10-05" dtype="1" dtyperef="Passport">
            <foundsource name="UBKI" found="0" foundref="Not found" sourcedate="2022-10-16"/>
            <foundsource name="MVS" found="1" foundref="Found" sourcedate="2022-10-16"/>
            <foundsource name="DMS" found="0" foundref="Not found" sourcedate="2022-10-16"/>
        </mvd>
    </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="22" descr="Result of verification of Full Name-Passport-DOB">
        <passportverif coincide="1" coincideref="Yes" existident="1" existidentref="Yes" mname="ВАСИЛІВНА" fname="ІРІНА" lname="ГАРНА" bdate="1989-10-05" ser="АМ" nom="578072"/>
    </comp>
</ubkidata>

...