22 - Entrepreneur Dossier

22 - Entrepreneur Dossier


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


The report contains the following components:

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"

},

"additionaldata": {

"usearchive": "**Indication of using data from the archive in case of unavailability of the API (1 - use, 0 - do not use; default 0)",

"tender": {

       "role": "** Subject role (1 - Procuring entity; 2 - Participant; 3 - Winner; 4 - Complainant)",

        "startDate": "** Start date of the period from which tenders are selected",

       "endDate": "** End date of the period up to which tenders are selected",

       "status": "** Tender status (ref.76)",

        "procurementMethod": "** Procurement method (ref.76)",

       "startAmount": "** Tender value (from)",

       "endAmount": "** Tender value (to)",

        "prozorroId": "** Search by identifier from http://prozorro.gov.ua "

     }

   }

},

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

{

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

},

{

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

"atu": "Administrative-territorial unit",

"atu_code": "Code of the administrative-territorial unit (KOATUU, KATOTTG)"

},

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

"state": "Current status of a subject in EDR (Unified State Register) (code from ref. 64)",

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

},

"warTerritoryCheck": {

"warTerritory": [

{

"subjectType": "The type of entity whose address was checked",

"subjectName": "The name of entity whose address was checked",

"subjectAddress": "Address that was checked",

"warTerritoryInfo": {

"code": "Temporarily occupied territory code",

"name": "Name of the region",

"type": "Type of territorial unit",

"startDate": "Date of inclusion in the list of temporarily occupied territories",

"endDate": "Date of exclusion from the list of temporarily occupied territories",

"status": "Territory status (code)",

"statusText": "Territory status (text)"

}

}

],

"noWarTerritory": [

{

"subjectType": "The type of entity whose address was checked",

"subjectName": "The name of entity whose address was checked",

"subjectAddress": "Address that was checked"

}

],

"failed": [

{

"subjectType": "The type of entity whose address was checked",

"subjectName": "The name of entity whose address was checked",

"subjectAddress": "Address that was checked",

"errorMessage": "Error description"

}

]

},

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

"archiverecorddate": "Date of the information in archive"

},

"id": "24",

"descr": "Names of components"

},

{

"lawyerinfo": {

"registration": {

"numsv": "Number of the certificate of the right to practice law",

"datesv": "Certificate issue date",

"issuedsv": "Issuing authority",

"numdec": "Number of the decision on issuing a certificate",

"datedec": "Date of decision",

"stopinfo": "Information on the termination of the right to advocate"

},

"found": "Availability of information (Code from ref.27)",

"foundref": "Availability of information, decoding",

"typesearch": "Search type (Code from ref.67)",

"typesearchtext": "Search type, decoding",

"lname": "Subject's last name",

"fname": "Subject's first name",

"mname": "Subject's patronymic",

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

},

"notaryinfo": {

"found": "Availability of information (Code from ref.27)",

"foundref": "Availability of information, decoding",

"typesearch": "Search type (Code from ref.67)",

"typesearchtext": "Search type, decoding",

"lname": "Subject's last name",

"fname": "Subject's first name",

"mname": "Subject's patronymic",

"vdate": "Version date (date of update of information for this subject)",

"numsv": "Number of the certificate on the right to engage in notarial activity",

"registeredin": "Place of registration",

"nameoffice": "Name of the registered institution"

},

"deputatinfo": {

"found": "Availability of information (Code from ref.27)",

"foundref": "Availability of information, decoding",

"typesearch": "Search type (Code from ref.75)",

"typesearchtext": "Search type, decoding",

"registration": [

{

"subjectCode": "Entity identification code",

"lname": "Subject's last name",

"fname": "Subject's first name",

"mname": "Subject's patronymic",

"workplace": "Place of work",

"posttype": "Type of position",

"workpost": "Position",

"declarationlink": "Link to the declaration"

}

]

},

"judgeinfo": {

"found": "Availability of information (Code from ref.27)",

"foundref": "Availability of information, decoding",

"typesearch": "Search type (Code from ref.75)",

"typesearchtext": "Search type, decoding",

"registration": [

{

"subjectCode": "Entity identification code",

"lname": "Subject's last name",

"fname": "Subject's first name",

"mname": "Subject's patronymic",

"courtname": "Place of work"

}

]

},

"privateexecutor": {

"found": "Availability of information (Code from ref.27)",

"foundref": "Availability of information, decoding",

"typesearch": "Search type (Code from ref.75)",

"typesearchtext": "Search type, decoding",

"registration": [

{

"lname": "Subject's last name",

"fname": "Subject's first name",

"mname": "Subject's patronymic",

"certnum": "Number of certificate of right to operate",

"certdate": "Certificate issue date",

"area": "Place of issue",

"anotherinfo": "Additional information",

"activitydate": "Date of decision"

}

]

},

"id": "27",

"descr": "Information on official status and regulated professional activity"

},

{

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

},

{

"licensesCount": {

"licenseRegisters": [

{

"licenses": {

"licenseNo": "Batch license/permission number",

"licenseState": "License/Permission Status",

"typeLicense": "License/Permission Type",

"kindLicense": "License/Permission Type",

"licensePeriod": "License/Period Expiration Date",

"address": "Address",

"activityAddress": "Activity address",

"issueDate": "Date of license/permit",

"startDate": "License/permission effective date",

"endDate": "License/permission expiration date"

},

"licenseName": "License/permission name",

"licenseDepartment": "Issuing organ",

"newest": "Last license/permit date",

"count": "Number of licenses/permissions on this registry"

}

],

"okpo": "TIN of the client",

"found": "Numerical determination of the fact of licenses/permits",

"foundref": "Text definition of licenses/permissions Information not found/Information found",

"activeCountLicenses": "Number of valid licenses/permits",

"countLicensesName": "Number of types of licenses/permissions"

},

"tradeMarksInfo": {

"tradeMarks": [

{

"markText": [

{

"position": "Keyword ordinal number",

"text": "Keyword/phrase"

}

],

"holderSubjects": {

"subjectName": "Name/Full name of the owner",

"countryCode": "Country code of the owner",

"address": "Address of the owner",

"subjectCode": "EDRPOU/TIN of the owner",

"kind": "Type of owner of the trademark (natural person, legal entity, other)"

},

"applicantSubjects": {

"subjectCode": "Applicant's EDRPOU/TIN",

"subjectName": "Applicant's name/full name",

"kind": "Applicant type tm (natural person, legal entity, individual)"

},

"tmNo": "TM application number",

"regNo": "TM registration number",

"regDate": "TM registration date",

"appDate": "TM application date",

"state": "Registration status",

"logoURL": "TM image link"

}
],

"okpo": "ЄДРПОУ/ІПН суб’єкта пошуку",

"found": "Ознака наявності інформації (0 - інформації не знайдено, 1 - знайдена інформація про наявні торгові марки)",

"foundref": "Текстове значення ознаки наявності інформації",

"tradeMarksCount": "Кількість знайдених торгових марок",

},

"id": "63",

"descr": "Search for information on the availability of licenses, permits and trademarks"

},

{

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

},

{

"tendersStatData": {

"tenderCount": "Total number of tenders",

"lastYearCount": "Number of tenders (for the last year from the current date)",

"previousYearCount": "Number of tenders (for the previous year: from current date - 2 years to current date - 1 year)",

"activeTenderCount": "Number of active tenders (with status 'active')",

"procurCount": "Number of successfully completed tenders (for procurers)",

"canceledCount": "Number of canceled tenders (for procurers)",

"complaintTenderCount": "Number of tenders with complaints (for procurers)",

"roleProcuringCount": "Total number of tenders where the subject acted as the procurer",

"roleBidCount": "Number of tenders where the subject acted as an active participant",

"roleBidCancelledCount": "Number of tenders where the subject was a canceled participant",

"roleWinnerCount": "Number of tenders where the subject was an active winner",

"roleWinnerCancelledCount": "Number of tenders where the subject was a canceled winner",

"roleComplainantCount": "Number of tenders where the subject was a complainant",

"activeTenderAmount": "Total value of active tenders",

"avgTenderAmount": "Average tender value (overall)",

"avgTenderAmountLastYear": "Average tender value (for the previous year)",

"canceledRate": "Percentage of canceled tenders (for procurers)",

"canceledTenderAmount": "Total value of canceled tenders (for procurers)",

"procurRate": "Percentage of successfully completed tenders (for procurers)",

"tenderAmount": "Total value of all tenders",

"tenderAmountLastYear": "Value of tenders (for the last year from the current date)",

"tenderAmountPreviousYear": "Value of tenders (for the previous year: from current date - 2 years to current date - 1 year)",

"tenderAmountWithPdv": "Total value of tenders including VAT",

"winRate": "Percentage of wins (for participants)",