/
15 - Credit report of a legal entity

15 - Credit report of a legal entity


A credit report of a legal entity will be useful, in case of registration of a loan contract, execution of the contract with a new partner, as wells as when the verification of the existing contractors is required. The report allows you to verify the existence, location of the founders, as well as dept obligations of a legal entity.


Http Method

POST

Request JSON

{

"doc": {

"ubki": {

"req_envelope": {

"req_xml": {

"request": {

"i": {

"ident": {

"okpo": "EGRPOU (for legal entities)"

},

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

},

"version": "1.0",

"reqtype": "Template code (Code from the ref.49): 'Credit report of a legal entity ' - 15",

"reqreason": "Purpose of the request (Code from the ref.24)"

},

"descr": "Request object"

},

"descr": "Request envelope"

},

"sessid": "Session key (we receive it from the API authorization)"

}

}

}

Response JSON

{

"ubkidata": {

"tech": {

"trace": {

"step": {

"name": "Step name",

"stm": "Date-stamp of the step start",

"ftm": "Date-stamp of the step end"

}

},

"error": {

"errtype": "Error code (code from ref.0)",

"errtext": "Error text (value from ref.0)"

},

"reqinfo": {

"reqid": "The outgoing ID request, generated by the Ukrainian Bureau of the Credit History"

},

"billing": {

"balance": {

"value": "Balance amount",

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

{

"cki": {

"urident": {

"donor": "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)",

"okpo": "EGRPOU of the legal entity",

"urname": "Name of the legal entity",

"urfrms": "Form of ownership (Code from ref.38)",

"urfrmsref": "Form of ownership (Meaning from ref.38)",

"ureconom": "Branch of economy (Section KVED2010) (Code from ref.36)",

"ureconomref": "Branch of economy (Section KVED2010) (Meaning from ref.36)",

"urvide": "Business activity (KVED2010) (Code from ref.37)",

"urvideref": "Business activity (KVED2010) (Code from ref.37)",

"urdatreg": "Date of registration in the Unified State Register",

"urdatregnal": "Date of registration in the tax inspectorate"

},

"linked": {

"ldonor": "A source of information (code from ref.54)",

"okpo2": "INN/EGRPOU of the related person",

"okpo2_name": "Full name/Name of the related person",

"linkrole": "Type of connection (Code from ref.39)",

"linkroleref": "Type of connection (Meaning from ref.39)",

"rdate": "Connection updated date"

},

"doc": {

"ddonor": "Source of information (code from ref. 54)",

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

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

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

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

"dtyperef": "Document type (value from ref.7)",

"dser": "Document series",

"dnom": "Document number",

"dterm": "Expiration date",

"dwho": "Document issuer",

"dwdt": "Document issue date",

"eddr_number": "Unique record number in the Unified State Demographic Register"

},

"addr": {

"addonor": "Source of information (code from ref.54)",

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

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

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

"adtype": "Address type (code from ref.9)",

"adtyperef": "Address type (value from ref.9)",

"adcountry": "Country (two-character code from ISO 3166 reference book)",

"adindex": "Postal code",

"adstate": "Region",

"adarea": "District",

"adcity": "Locality",

"adcitytype": "Locality type (code from ref.22)",

"adcitytyperef": "Locality type (value from ref.22)",

"adstreet": "Street",

"adhome": "House",

"adcorp": "Block",

"adflat": "Flat",

"addrdirt": "Address in one row (will not be used in subsequent API versions, the field is deemed invalid starting from 13.11.2019)"

},

"inn": "EGPROU of the legal entity",

"lname": "Name of the legal entity",

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

},

"id": "1",

"descr": "Components name"

},

{

"donorsData": {

"donorTypeDealCount": {

"type": "Source/donor of information (code from ref. 54)",

"typeref": "Source/donor of information (value from ref. 54)",

"count": "The number of deals"

},

"totalCount": "Total number of unique creditors",

"activeCount": "Number of unique creditors under current agreements"

},

"crdeal": {

"deallife": {

"dlref": "Transaction identifier",

"dlmonth": "Data period (month)",

"dlyear": "Data period (year)",

"dlds": "Date of the transaction beginning",

"dldpf": "Date of the transaction ending by the agreement",

"dldff": "Actual date of the transaction ending",

"dlflstat": "Transaction Status at the current period (Code from ref.16)",

"dlflstatref": "Transaction status at the current period (Meaning from ref.16)",

"dlamtlim": "Current transaction limit (for revolving transactions, credit cards)",

"dlamtpaym": "The amount of the obligatory payment in the current period",

"dlamtcur": "The sum of the current debt",

"dlamtexp": "The sum of the current outstanding debt",

"dldayexp": "Current number of days in arrears",

"dlflpay": "The sign of payment execution in the current period (the code from ref.13)",

"dlflpayref": "The sign of payment execution in the current period (Meaning from ref.13)",

"dlflbrk": "The sign of the existence of an outstanding payment in the current period (the code from ref.13)",

"dlflbrkref": "The sign of the existence of an outstanding payment in the current period (Meaning from ref.13)",

"dlfluse": "Characteristics of a credit tranche in the current period (code from ref.13)",

"dlfluseref": "Characteristics of a credit tranche in the current period (Meaning from ref.13)",

"dldateclc": "Calculation Date"

},

"dlref": "Transaction identifier",

"lng": "Block representation language (Code from ref.23)",

"lngref": "Block representation language (Meaning from ref.23)",

"inn": "INN SKI / EGRPOU of the legal entity",

"lname": "Surname/Name of the legal entity",

"fname": "Name",

"mname": "Father’s name",

"bdate": "Date of Birth",

"dlcelcred": "Transaction type (Code from ref.17)",

"dlcelcredref": "Transaction type (Meaning from ref.17)",

"dlvidobes": "Type of collateral (Code from ref.15)",

"dlvidobesref": "Type of collateral (Meaning from ref.15)",

"dlporpog": "Repayment procedure (Code from ref.18)",

"dlporpogref": "Repayment procedure (Meaning from ref.18)",

"dlcurr": "Transaction currency (Code from ref.12)",

"dlcurrref": "Transaction currency (Meaning from ref.12)",

"dlamt": "Transaction sum (initial)",

"dldonor": "Information donor (code from ref.54)",

"dldonornum": "Information on the unique number of the creditor",

"dlrolesub": "Role of the subject (Code from ref.14)",

"dlrolesubref": "Role of the subject (Meaning from ref.14)",

"dlamtobes": "Cost of collateral in the base currency"

},

"id": "2",

"descr": "Components name"

},

{

"penaltiesCount": {

"totalCount": "The total number of enforcement proceedings for all time",

"activeCount": "Number of active enforcement proceedings"

},

"susd": {

"changes": {

"voteid": "Enforcement Number",

"inn": "TIN of the debtor",

"votedate": "Enforcement start date",

"votesudname": "Executor",

"vdate": "Record Date",

"credname": "Name of creditor",

"credokpo": "Creditor`s code",

"vpstate": "Status of proceedings"

},

"votesudname": "Executor",

"votetype": "Enforcement type",

"votedate": "Enforcement start date",

"inn": "TIN of the debtor",

"voteid": "Enforcement Number",

"votedonor": "Source of information",

"votesudphone": "Executor’s phone",

"votesudemail": "Executor’s email",

"vdate": "Record update date",

"credname": "Creditor name",

"credokpo": "Creditor`s code",

"vpstate": "Status of proceedings"

},

"id": "3",

"descr": "Information on the enforcement proceedings of SKI"

},

{

"credres": {

"redate": "Date of decision",

"retime": "Time of decision",

"inn": "INN",

"reqid": "Request identifier in the Bureau",

"result": "Report result (Code from ref.19)",

"resultref": "Report result (Meaning from ref.19)",

"reqreason": "Reason for the request in to the bureau (Code from ref.24)",

"reqreasonref": "Reason for the request in to the bureau (Meaning from