22 - Entrepreneur Dossier

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"

},

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

{

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

},

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

"regionalDistribution": [

{

"areaId": "Region code (ref. 76)",

"procurementCount": "Number of tenders in which the subject acted as the procurer",

"bidCount": "Number of tenders in which the subject participated (as a bidder)",

"winCount": "Number of tenders in which the subject was identified as the winner"

}

]

},

"tendersData": {

  "found": "0 - Information not found, 1 - Information found",

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

   "tenderCount": "Total number of tenders found",

   "activeTenderCount": "Number of active tenders",

   "cancelledTenderCount": "Number of canceled tenders",

   "tenderCountLastYear": "Number of tenders in the last year",

   "tenders": [

     {

       "mainRole": "Role of the entity in the tender (ref. 76)",

       "otherRoles": "Role of the entity in the tender (ref. 76)",

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

       "tenderId": "Internal tender ID",

       "tenderIdUa": "Tender ID in Prozzorro",

       "tenderCreateDate": "Tender creation date",

       "tenderEventDate": "Tender last modification date",

       "title": "Tender title or description",

       "amount": "Number of goods or services",

       "currency": "Currency in which the price is specified",

       "valueAddedTaxIncluded": "VAT inclusion indicator in the price",

       "procurementCategory": "Procurement category",

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

       "tenderStartDate": "Tender start date",

       "tenderEndDate": "Tender end date",

        "awardStartDate": "Start date of determining the winner",

        "awardEndDate": "End date of determining the winner",

       "nextCheckDate": "Next tender check date",

       "items": [

         {

           "classificationId": "Classifier ID",

           "classificationScheme": "Classifier scheme",

           "classificationName": "Product/service name from the classifier",

           "itemDescription": "Product description",

           "amount": "Quantity",

          "unit": "Unit of measurement"

         }

       ],

       "procuring": {

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

          "subjectName": "Name of legal entity or full name of individual entrepreneur",

         "kind": "Type of customer (ref. 76)",

         "address": {

           "country": "Country",

           "postalCode": "Postal code",

           "region": "Region",

           "city": "City",

           "street": "Street"

         },

         "contact": {

           "name": "Contact Name",

            "email": "Contact Email",

           "phone": "Contact Phone"