30 - Telecom Report


Mobile phone credit history.


The report contains the following components:

Explanation to report

1. Chronology of the dates when:

- the phone number was provided together with the credit history

- there was a credit application with the specified phone number

- transactions with the specified phone number were executed in UBKI payment systems

- transactions with the specified phone number were executed in UBKI partners’ payment systems

2. Labeled TIN’s encountered with the mobile phone number, and the contact’s role at the moment of making a record

3. Calculated credit score for TIN’s encountered together with the mobile phone number.

4. Number of financial institutions that have transferred credit histories or credit applications with the specified phone number.

Http Method

POST

Request JSON

{

"doc": {

"ubki": {

"req_envelope": {

"req_xml": {

"request": {

"i": {

"telecom": {

"phone": "Mobile phone number in +380999999999 format",

"datecut": "Date of the report calculation. If the date = '' – calculated for today, otherwise – for the beginning of the day specified"

},

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

},

"version": "1.0",

"reqtype": "Template code (code from ref.49): 'Telecom Report' report – 30",

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

},

"descr": "Request object"

},

"descr": "Request envelope"

},

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

}

}

}

Response JSON

{

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

"telecom": {

"phone": "Mobile phone number in +380900000009 format",

"uo": "Qty of unique organizations that have transferred credit histories with a phone number or a credit application with a phone number"

},

"conth": {

"vdate": "Date of the information from this part",

"innm": "Labeled TIN (*******111)",

"tcsource": "Source of the 'Telecom Report' part (code from ref.52)",

"tcsourceref": "Reference for source of the 'Telecom Report' part (code from ref.52)",

"tctype": "Contact type in the 'Telecom Report' part (code from ref.53)",

"tctyperef": "Reference for contact type in the 'Telecom Report' part (code from ref.53)",

"tcdonor": "Provider (code from ref.54)"

},

"scores": {

"innm": "Labeled TIN (*******111)",

"score": "Credit score (0-700, NA)",

"agerange": "Age range (0_17, 18_24, 25_34, 35_44, 45_54, 55_64, 65_more)"

},

"id": "35",

"descr": "Names of components"

}

}

}

Request XML

<?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): 'Telecom Report' report – 30" reqreason="Request objective (code from ref.24)">

<!-- Parameters describing search criteria-->

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

<!-- Search options -->

<telecom phone="Mobile phone number in +380999999999 format"

datecut="Date of the report calculation. If the date = '' – calculated for today, otherwise – for the beginning of the day specified" />

</i>

</request>

</req_xml>

</req_envelope>

</ubki>

</doc>

Response XML

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

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

<telecom phone="Mobile phone number in +380900000009 format"

uo="Qty of unique organizations that have transferred credit histories with a phone number or a credit application with a phone number" />

<conth vdate="Date of the information from this part"

innm="Labeled TIN (*******111)"

tcsource="Source of the 'Telecom Report' part (code from ref.52)"

tcsourceref="Reference for source of the 'Telecom Report' part (code from ref.52)"

tctype="Contact type in the 'Telecom Report' part (code from ref.53)"

tctyperef="Reference for contact type in the 'Telecom Report' part (code from ref.53)"

tcdonor="Provider (code from ref.54)" />

<scores innm="Labeled TIN (*******111)"

score="Credit score (0-700, NA)"

agerange="Age range (0_17, 18_24, 25_34, 35_44, 45_54, 55_64, 65_more)" />

</comp>

</ubkidata>

Example

Example

Request JSON

{ "doc": { "ubki": { "req_envelope": { "req_xml": { "request": { "i": { "telecom": { "phone": "+380962134234", "datecut": "" }, "reqlng": "4" }, "version": "1.0", "reqtype": "30", "reqreason": "2" } } }, "sessid": "F936E3872D7740D7910BB32C933318B3" } } }

Response JSON

{ "ubkidata": { "tech": { "trace": { "step": { "name": "build report", "stm": "2022-08-26 09:58:11.722", "ftm": "2022-08-26 09:58:11.839" } }, "reqinfo": { "reqid": "req2#000002460378" } }, "comp": { "telecom": { "conth": [ { "vdate": "2021-05-25", "innm": "*******288", "tcsource": "1", "tcsourceref": "Credit history", "tctype": "1", "tctyperef": "Personal mobile phone", "tcdonor": "BNK" }, { "vdate": "2016-04-29", "innm": "*******288", "tcsource": "4", "tcsourceref": "Payment service provider", "tctype": "1", "tctyperef": "Personal mobile phone", "tcdonor": "PSP" }, { "vdate": "2015-10-18", "innm": "*******288", "tcsource": "4", "tcsourceref": "Payment service provider", "tctype": "1", "tctyperef": "Personal mobile phone", "tcdonor": "PSP" }, { "vdate": "2013-09-04", "innm": "*******223", "tcsource": "1", "tcsourceref": "Credit history", "tctype": "1", "tctyperef": "Personal mobile phone", "tcdonor": "BNK" }, { "vdate": "2010-09-23", "innm": "*******223", "tcsource": "1", "tcsourceref": "Credit history", "tctype": "1", "tctyperef": "Personal mobile phone", "tcdonor": "BNK" }, { "vdate": "2009-09-30", "innm": "*******619", "tcsource": "1", "tcsourceref": "Credit history", "tctype": "1", "tctyperef": "Personal mobile phone", "tcdonor": "BNK" } ], "scores": [ { "innm": "*******288", "score": "446", "agerange": "25_34" }, { "innm": "*******223", "score": "NA", "agerange": "45_54" }, { "innm": "*******619", "score": "0", "agerange": "0_17" } ], "phone": "+380962134234", "datecut": "2021-11-29 10:30:47", "uo": "1" }, "id": "35", "descr": "Telecom report" } } }

Request XML

<?xml version="1.0" encoding="UTF-8"?> <doc> <ubki sessid="F936E3872D7740D7910BB32C933318B3"> <req_envelope> <req_xml> <request version="1.0" reqtype="30" reqreason="2"> <i reqlng="4"> <telecom phone="+380962134234" datecut="" /> </i> </request> </req_xml> </req_envelope> </ubki> </doc>

Response XML

Test URL

Test data

  • phone="+380962134234"

  • phone="+380662134234"

  • phone="+380981224895"

  • phone="+380732144444"

  • phone="+380971321122"

  • phone="+380935171868"

  • phone="+380981220000"