22 - Entrepreneur Dossier


A body of documented information about an individual entrepreneur from state registers, other public databases, and open sources.


Http Method

POST

Request JSON
( ** parameters are passed optionally)

{

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

},

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

},

"version": "1.0",

"reqtype": "Template code (code from ref.49): 'Search for an entrepreneur’s records from state registers' report – 22",

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

{

"entrepreneurdossier": {

"record": {

"bankruptcy": {

"date": "Date of recording bankruptcy proceedings registration",

"state": "Status of a subject",

"statetext": "Textual display of status",

"docdate": "Proceedings opening date",

"courtname": "Name of court",

"docnumber": "Proceedings number",

"datejudge": "Effective date"

},

"openenforcements": {

"openenforcement": {

"date": "Enforcement proceedings opening date"

}

},

"terminationcancel": {

"date": "Date of canceling the record of business termination",

"recordnumber": "Record number",

"docnumber": "Bankruptcy document number",

"docdate": "Document date",

"datejudge": "Effective date",

"courname": "Name of court"

},

"names": {

"name": "Full name of an individual",

"shortname": "Abbreviated name",

"display": "Display name",

"country":"Name of the country of citizenship"

},

"registration": {

"date": "Date of registration in EDR (Unified State Register)",

"recordnumber": "Date of recording of registration in EDR (Unified State Register)",

"recorddate": "Date of recording in EDR (Unified State Register)",

"isseparation": "State registration of a legal entity by allotment",

"isdivision": "State registration of a legal entity by separation",

"ismerge": "State registration of a legal entity by way of merger",

"istransformation": "State registration of a legal entity by reorganization",

"objectname": "Storage location of a registration file",

"pervregistrationendterm": "Duration of registration of an individual entrepreneur in the Ministry of Revenue, in case of change of place of residence"

},

"registrations": {

"name": "Registration office name",

"code": "EDRPOU of a registration office",

"type": "Registration office type",

"description": "Information about the departmental registry",

"startdate": "Date of registration",

"startnum": "Registration number",

"enddate": "Date of de-registration",

"endnum": "De-registration number"

},

"primaryactivitykind": {

"name": "Name of principal activity type",

"code": "Code of principal activity type under the Classifier of economic activities",

"regnumber": "Date of recording of principal activity type registration",

"class": "Principal activity risk class"

},

"activitykinds": {

"name": "Name of activity type",

"code": "Code of activity type under the Classifier of economic activities",

"isprimary": "Indication of the principal activity type (1 – principal, 0 – non-principal)"

},

"contacts": {

"type": "Contact type (webpage, email, tel, fax)",

"value": "Contact value"

},

"address": {

"zip": "Place of residence postal code",

"country": "Country of residence",

"address": "Full residential address"

},

"termination": {

"state": "Status code of the record of business termination (2 – pending termination, 3 – terminated)",

"statetext": "Description of termination record status",

"date": "Record date",

"recordnumber": "De-registration number",

"cause": "Grounds for its entering"

},

"iscurrent": "0/1 (1 – relevant record of business activities, 0 – previous record of business activities)"

},

"found": "Status in the Unified State Register (code from ref.27)",

"inn": "Business entity TIN",

"curstate": "Current status of a subject in EDR (code from ref.64)",

"curstatetxt": "Additional comment on current status of a subject (value from ref.64)",

"currecorddate": "Current registration date"

},

"id": "24",

"descr": "Names of components"

},

{

"lawyerinfo": {

"registration": {

"anotherinfo": {

"value": "Other information"

},

"contacts": {

"mphone": "Mobile phone",

"wphone": "Landline phone number",

"email": "E-mail",

"contactinfo": "Contact details"

},

"numsv": "Number of a license to practice law",

"datesv": "License issue date",

"issuedsv": "Issuing authority",

"numdec": "Number of the decision to issue a license",

"datedec": "Date of decision",

"stopinfo": "Information about terminating a license to practice law"

},

"vdate": "Version date (date of the update of information for this TIN)"

},

"id": "27",

"descr": "Names of components"

},

{

"bankruptcyinfo": {

"bankruptcy": {

"subname": "Subject’s name",

"subcode": "TIN/EDRPOU",

"eventtype": "Event type",

"eventclaimer": "Initiator of the event",

"eventcourtcase": "Case number",

"eventdate": "Date of event"

},

"found": "Availability of information about bankruptcy, numerical designation 0-1",

"foundref": " Availability of information about bankruptcy, textual meaning 0-not found / 1-found"

},

"id": "54",

"descr": "Bankruptcy information"

},

{

"pdvPayer": {

"okpo": "TIN",

"found": "0/1 - numerical determination of the fact of VAT registration",

"foundref": "Textual definition of the fact of VAT registration",

"codePDV": "Individual tax number",

"dateRegistry": "Date of registration by the taxpayer",

"dateCancel": "Date of cancellation of registration",

"reasonCancel": "Legal grounds for cancellation",

"lawReason": "Reason for cancellation",

"pubRegister": "Registry name",

"vdate": "Date of update in the database"

},

"id": "66",

"descr": "Information from the register of VAT payers"

}

]

}

}

Request XML
( ** parameters are passed optionally)

<?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): 'Search for an entrepreneur’s records from state registers' report – 22" 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>

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

<!-- Search for an entrepreneur’s records from state registers -->

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

<entrepreneurdossier found="Status in the Unified State Register (code from ref.27)"

inn="Business entity TIN"

curstate="Current status of a subject in EDR (code from ref.64)"

curstatetxt="Additional comment on current status of a subject (value from ref.64)"

currecorddate="Current registration date">

<record iscurrent="0/1 (1 – relevant record of business activities, 0 – previous record of business activities)">

<bankruptcy date="Date of recording bankruptcy proceedings registration"

state="Status of a subject"

statetext="Textual display of status"

docdate="Proceedings opening date"

courtname="Name of court"

docnumber="Proceedings number"

datejudge="Effective date" />

<openenforcements>

<openenforcement date="Enforcement proceedings opening date" />

</openenforcements>

<terminationcancel date="Date of canceling the record of business termination"

recordnumber="Record number"

docnumber="Bankruptcy document number"

docdate="Document date"

datejudge="Effective date"

courname="Name of court" />

<names name="Full name of an individual"

shortname="Abbreviated name"

display="Display name"

country="Назва країни громадянства"/>

<registration date="Date of registration in EDR (Unified State Register)"

recordnumber="Date of recording of registration in EDR (Unified State Register)"

recorddate="Date of recording in EDR (Unified State Register)"

isseparation="State registration of a legal entity by allotment"

isdivision="State registration of a legal entity by separation"

ismerge="State registration of a legal entity by way of merger"

istransformation="State registration of a legal entity by reorganization"

objectname="Storage location of a registration file"

pervregistrationendterm="Duration of registration of an individual entrepreneur in the Ministry of Revenue, in case of change of place of residence" />

<registrations name="Registration office name"

code="EDRPOU of a registration office"

type="Registration office type"

description="Information about the departmental registry"

startdate="Date of registration"

startnum="Registration number"

enddate="Date of de-registration"

endnum="De-registration number" />

<primaryactivitykind name="Name of principal activity type"

code="Code of principal activity type under the Classifier of economic activities"

regnumber="Date of recording of principal activity type registration"

class="Principal activity risk class" />

<activitykinds name="Name of activity type"

code="Code of activity type under the Classifier of economic activities"

isprimary="Indication of the principal activity type (1 – principal, 0 – non-principal)" />

<contacts type="Contact type (webpage, email, tel, fax)"

value="Contact value" />

<address zip="Place of residence postal code"

country="Country of residence"

address="Full residential address" />

<termination state="Status code of the record of business termination (2 – pending termination, 3 – terminated)"

statetext="Description of termination record status"

date="Record date"

recordnumber="De-registration number"

cause="Grounds for its entering" />

</record>

</entrepreneurdossier>

</comp>

<!-- Lawyers Information part -->

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

<lawyerinfo vdate="Version date (date of the update of information for this TIN)">

<registration numsv="Number of a license to practice law"

datesv="License issue date"

issuedsv="Issuing authority"

numdec="Number of the decision to issue a license"

datedec="Date of decision"

stopinfo="Information about terminating a license to practice law">

<anotherinfo value="Other information" />

<contacts mphone="Mobile phone"

wphone="Landline phone number"

email="E-mail"

contactinfo="Contact details" />

</registration>

</lawyerinfo>

</comp>

<!-- Bankruptcy information-->

<comp id="54" descr="Bankruptcy information">

<bankruptcyinfo found="Availability of information about bankruptcy, numerical designation 0-1"

foundref=" Availability of information about bankruptcy, textual meaning 0-not found / 1-found">

<bankruptcy subname="Subject’s name"

subcode="TIN/EDRPOU"

eventtype="Event type"

eventclaimer="Initiator of the event"

eventcourtcase="Case number"

eventdate="Date of event" />

</bankruptcyinfo>

</comp>

<!-- Information from the register of VAT payers -->

<comp id="66" descr="Information from the register of VAT payers">

<pdvPayer okpo="TIN"

found="0/1 - numerical determination of the fact of VAT registration"

foundref="Textual definition of the fact of VAT registration"

codePDV="Individual tax number"

dateRegistry="Date of registration by the taxpayer"

dateCancel="Date of cancellation of registration"

reasonCancel="Legal grounds for cancellation"

lawReason="Reason for cancellation"

pubRegister="Registry name"

vdate="Date of update in the database" />

</comp>

</ubkidata>

Example

Example

Request JSON

{ "doc": { "ubki": { "req_envelope": { "req_xml": { "request": { "i": { "ident": { "okpo": "3389956584" }, "reqlng": "4" }, "version": "1.0", "reqtype": "22", "reqreason": "2" } } }, "sessid": "F936E3872D7740D7910BB32C933318B3" } } }

Response JSON

{ "ubkidata": { "tech": { "trace": { "step": { "name": "build report", "stm": "2022-08-26 09:32:19.459", "ftm": "2022-08-26 09:32:19.485" } }, "reqinfo": { "reqid": "req2#000002460349" } }, "comp": [ { "entrepreneurdossier": { "record": [ { "names": { "name": "ВОДЯНОЙ СЕРГІЙ ФЕДОРОВИЧ", "shortname": "", "display": "ВОДЯНОЙ СЕРГІЙ ФЕДОРОВИЧ", "country":"Україна" }, "registration": { "date": "2004-12-27", "recordnumber": "22660002628", "recorddate": "2004-12-27", "isseparation": "0", "isdivision": "0", "ismerge": "0", "istransformation": "0", "objectname": "Ворошиловське районне управління юстиції у м. Донецьку", "prevregistrationendterm": "" }, "bankruptcy": "", "primaryactivitykind": { "name": "ОПТОВА ТОРГІВЛЯ ПРОДУКТАМИ ХАРЧУВАННЯ, НАПОЯМИ ТА ТЮТЮНОВИМИ ВИРОБАМИ", "code": "51.3", "regnumber": "", "class": "" }, "activitykinds": [ { "name": "ОПТОВА ТОРГІВЛЯ ПРОДУКТАМИ ХАРЧУВАННЯ, НАПОЯМИ ТА ТЮТЮНОВИМИ ВИРОБАМИ", "code": "51.3", "isprimary": "1" }, { "name": "ОПТОВА ТОРГІВЛЯ ІНШИМИ ПРОДУКТАМИ ХАРЧУВАННЯ", "code": "51.38", "isprimary": "0" }, { "name": "ІНШІ ВИДИ ОПТОВОЇ ТОРГІВЛІ", "code": "51.7", "isprimary": "0" }, { "name": "РОЗДРІБНА ТОРГІВЛЯ ПОЗА МАГАЗИНАМИ", "code": "52.6", "isprimary": "0" }, { "name": "РОЗДРІБНА ТОРГІВЛЯ ПОЗА МАГАЗИНАМИ, Н. В. І. Г.", "code": "52.63", "isprimary": "0" } ], "contacts": [ { "type": "email", "value": "" }, { "type": "fax", "value": "" }, { "type": "webpage", "value": "" }, { "type": "tel", "value": "8(062)348-17-79" } ], "address": { "zip": "83000", "country": "УКРАЇНА", "address": "БР.ПУШКІНА, М.ПИРЯТИН, ВОРОШИЛОВСЬКИЙ РАЙОН, Києвська ОБЛАСТЬ" }, "termination": { "state": "3", "statetext": "припинено", "date": "2007-03-22", "recordnumber": "22660062342342002628", "cause": "Припинення ФОП за її рішенням" }, "terminationcancel": "", "openenforcements": "", "state": "", "statetxt": "" }, { "names": { "name": "ВОДЯНОЙ СЕРГІЙ ФЕДОРОВИЧ", "shortname": "", "display": "ВОДЯНОЙ СЕРГІЙ ФЕДОРОВИЧ" }, "registration": { "date": "2008-01-09", "recordnumber": "22600040627", "recorddate": "2008-01-09", "isseparation": "0", "isdivision": "0", "ismerge": "0", "istransformation": "0", "objectname": "Ворошиловське районне управління юстиції у м. Донецьку", "prevregistrationendterm": "" }, "bankruptcy": "", "registrations": [ { "name": "ГОЛОВНЕ УПРАВЛІННЯ РЕГІОНАЛЬНОЇ СТАТИСТИКИ", "code": "21680000", "type": "", "description": "", "startdate": "", "startnum": "", "enddate": "", "endnum": "" }, { "name": "МАРIУПОЛЬСЬКА ОБЄДНАНА ДЕРЖАВНА ПОДАТКОВА IНСПЕКЦIЯ ГОЛОВНОГО УПРАВЛIННЯ ДФС У ДОНЕЦЬКIЙ ОБЛАСТI (ПIВНIЧНЕ ВIДДIЛЕННЯ ВОРОШИЛОВСЬКИЙ РАЙОН М.ДОНЕЦЬК)", "code": "395553670", "type": "4002", "description": "дані про взяття на облік як платника податків", "startdate": "", "startnum": "", "enddate": "", "endnum": "" }, { "name": "МАРIУПОЛЬСЬКА ОБЄДНАНА ДЕРЖАВНА ПОДАТКОВА IНСПЕКЦIЯ ГОЛОВНОГО УПРАВЛIННЯ ДФС У ДОНЕЦЬКIЙ ОБЛАСТI (ПIВНIЧНЕ ВIДДIЛЕННЯ ВОРОШИЛОВСЬКИЙ РАЙОН М.ДОНЕЦЬК)", "code": "395553670", "type": "4001", "description": "дані про взяття на облік як платника єдиного внеску", "startdate": "", "startnum": "", "enddate": "", "endnum": "" } ], "primaryactivitykind": { "name": "Оброблення даних, розміщення інформації на веб-вузлах і повязана з ними діяльність", "code": "63.11", "regnumber": "05-15-11-99786", "class": "" }, "activitykinds": [ { "name": "Неспеціалізована оптова торгівля", "code": "46.90", "isprimary": "0" }, { "name": "Консультування з питань інформатизації", "code": "62.02", "isprimary": "0" }, { "name": "Інша діяльність у сфері інформаційних технологій і компютерних систем", "code": "62.09", "isprimary": "0" }, { "name": "Оброблення даних, розміщення інформації на веб-вузлах і повязана з ними діяльність", "code": "63.11", "isprimary": "1" }, { "name": "Консультування з питань комерційної діяльності й керування", "code": "70.22", "isprimary": "0" }, { "name": "Дослідження конюнктури ринку та виявлення громадської думки", "code": "73.20", "isprimary": "0" } ], "contacts": [ { "type": "email", "value": "b.bogdanov@gmail.com" }, { "type": "fax", "value": "" }, { "type": "webpage", "value": "" }, { "type": "tel", "value": "+380500000000" } ], "address": { "zip": "83111", "country": "УКРАЇНА", "address": "Києвська обл., місто ПИРЯТИН, Ворошиловський район БУЛЬВАР ПУШКІНА" }, "termination": { "state": "3", "statetext": "припинено", "date": "2018-01-25", "recordnumber": "2266232346004040627", "cause": "Припинення ФОП за її рішенням" }, "terminationcancel": "", "openenforcements": "", "state": "", "statetxt": "" } ], "found": "1", "inn": "3389956584", "curstate": "3", "curstatetxt": "припинено", "currecorddate": "2008-01-09" }, "id": "24", "descr": "Information about entrepreneur from the public registries" }, { "lawyerinfo": { "lname": "", "fname": "", "mname": "", "vdate": "" }, "id": "27", "descr": "Information from the Lawyers Registry" }, { "bankruptcyinfo": { "found": "0", "foundref": "Bankruptcy information unknown" }, "id": "54", "descr": "Bankruptcy information" }, { "pdvPayer": { "okpo": "3389956584", "found": "1", "foundref": "Found information", "codePDV": "2829454394", "dateRegistry": "1998-11-09", "dateCancel": "2009-01-15", "reasonCancel": "Анульовано за iнiцiативою платника", "lawReason": "Пп.184.1 ст.184 Кодексу", "pubRegister": "Реєстр платників ПДВ", "vdate": "2022-03-22" }, "id": "66", "descr": "Information from the register of VAT payers" } ] } }

Request XML

<?xml version="1.0" encoding="UTF-8"?> <doc> <ubki sessid="F936E3872D7740D7910BB32C933318B3"> <req_envelope> <req_xml> <request version="1.0" reqtype="22" reqreason="2"> <i reqlng="4"> <ident okpo="3389956584" /> </i> </request> </req_xml> </req_envelope> </ubki> </doc>

Response XML

Test URL

Test data

  • The current status of the subject in the EDR "registered" - 2726020593, 2425233680

  • The current status of the subject in the EDR "in a state of termination" - 3180423380

  • The current status of the subject in the EDR "terminated" - 3389956584, 3088764289

 

<comp id="27" descr="Lawyers information">

okpo="2661152187"

okpo="1993081882"

<comp  id="66" descr="Information from the register of VAT payers">

okpo="3389956584"