Description of the Check✓Lists FinAP® service operation
FinAP CheckLists is a tool for reporting entities to perform the tasks and responsibilities defined by the Law of Ukraine On Prevention and Counteraction to Legalization (Laundering) of Proceeds from Crime, Terrorist Financing, and Financing of Proliferation of Weapons of Mass Destruction, in particular such as customer insight and clarification of information about the customer, analysis of the compliance of financial transactions of the customer / contractor with the available information about the customer in order to identify financial transactions subject to financial monitoring.
CheckLists FinAP® uses latest search data, namely:
Lists of Politically Exposed Persons (PEPs) — national and foreign public figures, as well as persons who perform or have performed political functions in international organizations
Sanction lists — lists of persons connected with terrorist activities or subject to special economic and other restrictive measures (sanctions):
State Financial Monitoring Service of Ukraine (SFMS)
National Security and Defence Council of Ukraine (NSDC)
United Nations (UN) Security Council
European Union (EU)
United Kingdom (UK)
United States of America (OFAC)
Canada (CAN)
Databases of lost documents — information about the stolen, lost, or invalidated documents.
State registers — the Unified State Register of Legal Entities, Individual Entrepreneurs, and Public Organizations.
Analysis of changes in the USR — search for changes of the form of incorporation or name / address / manager / primary activity / status / final beneficiary / participant or founder in the Unified State Register of Legal Entities, Individual Entrepreneurs, and Public Organizations that took place during the specified period as to the determined list of legal entities.
Tax debtors — contains information on business entities (legal entities and individual entrepreneurs) that have (or had) a tax debt.
Licenses — provides information on licensees of construction activities, gambling business, and issuers of securities.
Adjudication record — provides information on court rulings grouped by case number in terms of parties to the proceedings and the form of proceedings.
Using this search data makes it possible to always check the following:
Affiliation of customers / contractors to national and foreign public figures or related persons
Inclusion in the lists of persons connected with terrorist activities or subject to international sanctions (sanctions lists)
Absence of documents provided by the customer / contractor in the database of lost documents
Reliability of customer data on relation of the customer to business entities where the customer / contractor is the ultimate beneficial owner or founder
Changes in the Unified State Register of Legal Entities related to your customers
CheckLists FinAP® server addresses:
URL: http://finap.com.ua:9999/api
URL: https://finap.com.ua:9443/api
What’s new?
CHECKLISTS API 1.1
New search register “Register of execution proceedings” (executive) is added
Input parameters doctype – Document type. May obtain the meaning 1 (PASSPORT OF THE CITIZEN OF UKRAINE including ID cards) and 2 (PASSPORT OF THE CITIZEN OF UKRAINE FOR TRAVELING ABROAD). If this parameter is mentioned, the search will be conducted only among the documents of this type. Otherwise the search is conducted irrespective of the type of the document.
Outgoing parameters level – level of correspondence in the Registers of “Public figures” and “Sanction lists”. It may obtain the meanings of “High” and “Low”.
In the block of the answer on search registers the test message with an error "9004.There is no connection with a database of service" is added.
CHECKLISTS API 1.0
The input parameter of address has been replaced with city. This parameter is used in the search for information on the USR of LEs and IEs (especially when searching for sole proprietors) and in the register of tax debtors (especially when searching for individuals or IEs)
In the response block on the Public Figures search register, 2 output parameters of typePEP and descriptiontypePEP have been added; the categoryPEP parameter can now contain a list (separated by ‘;’) of categories to which the PEP belongs according to K019 NBU reference book
In the response block on the search Sanction Lists register, the sanctionSource structure has been added to the response on the NSDC registers with the description of a source from which it was entered (the order of the president)
In the response block on the Tax Debtors search register, the dsumesv – unified social tax debt output parameter has been added. In the response block on the Licences search register, the gambling block has been added concerning gambling business licences.
Name |
Type of value |
Description of the ‘name/value’ pair |
Peculiarities of usage |
IDinternal |
numeric* |
Internal unique request ID (generated by the reporting entity’s internal software means) |
|
DateRequest |
datetime |
Date and time of request generation (generated by the reporting entity’s internal software means) in the ‘YYYY-MM-DD hh:mm:ss’ format |
|
IDsubjectFM |
string* |
Reporting entity ID (assigned when registering a reporting entity in the ‘FinAP CheckLists’ PC) |
|
IDuserPC |
numeric* |
The workplace ID of the reporting entity (assigned when registering the workplaces of the reporting entity in the ‘FinAP CheckLists’ PC) |
|
name |
string |
Full name or name of the customer / contractor |
|
namelat |
string |
Full name or name of the customer / contractor in Latin characters (can be formed based on the results of the transliteration algorithm operation) |
|
date |
date |
Date of birth of the individual customer / contractor (date of legal entity incorporation) in the ‘YYYY-MM-DD’ format |
|
ipn |
string |
Tax Identification Number of an individual or USREOU of a legal entity (optional field, most lists do not contain data on TIN or USREOU) |
|
city |
string |
Settlement name. It is used to search for entrepreneurs in the USR of LEs and IEs by place of registration, as well as in the register of tax debtors by tax affiliation. |
|
doc |
string |
Details of the customer / contractor document |
|
listdata |
тumeric* |
The number, each bit of which, when converted to binary format, determines the list of databases (lists) to search in (or the sum of numbers that match the search lists). For example, to search for ‘listdata’ in the current sanctions lists: 127 — ‘0000 0000 0000 0111 1111’). See Table 2 |
|
search |
numeric |
Search method (1 — fulltext (default), 2 — contextual...) |
|
finmon |
boolean** |
Sign of confirmation of the request results by the financial monitoring unit of the reporting entity (true — requires confirmation, false — default, no confirmation required) |
|
response type |
numeric** |
type of response (request result): 1 — permission response (allow); 2 — generalized (resume); 3 — short (short); 5 — full (full, default); |
|
textformat |
string** |
text field format for the full response type (responsetype=5); it can be set to ‘json’ (or ‘ ’ — by default), ‘xml’, ‘html’, or ‘text’ |
|
tokken |
string* |
Unique user key of a reporting entity (provided when registering reporting entity workplaces in ‘FinAP CheckLists’ PC) |
|
lowranklimit |
numeric |
Number that determines the lower limit of name or full name matches as a per cent (applies to Sanction Lists search data only) |
For the Sanctions Lists database (sanctions) |
edrchangesfrom |
date |
Date of start of the period of changes in the USR (for Analysis) in the ‘YYYY-MM-DD’ format |
For the ‘Analysis of Changes in the USR’ database (edrchanges) |
edrchangesto |
date |
End date of the change period in the USR (for Analysis) in the ‘YYYY-MM-DD’ format |
|
arrayedrpou |
string[] |
List (array) of USREOU codes for which changes in the USR during a given period are analysed |
|
doctype |
smallint |
Document type. May obtain the meaning 1 (PASSPORT OF THE CITIZEN OF UKRAINE including ID cards) and 2 (PASSPORT OF THE CITIZEN OF UKRAINE FOR TRAVELING ABROAD). |
|
* — required sets of ‘name/value’ pairs
** — reserved sets of pairs that are not currently used; the value is set to ‘default’
Decryption of the listdata parameter
#bit |
Number |
Search data (lists) name |
|
Search data group |
1 |
1 |
SFMS |
SFMS |
sanlists |
2 |
2 |
NSDC |
NSDC |
|
3 |
4 |
UN |
UN |
|
4 |
8 |
EU |
European Union |
|
5 |
16 |
UK |
United Kingdom |
|
6 |
32 |
OFAC |
USA |
|
7 |
64 |
CANADA |
Canada |
|
8 |
128 |
reserve |
|
|
9 |
256 |
reserve |
|
|
10 |
512 |
PEP |
National public figures |
pep |
11 |
1,024 |
PEP IntOrg |
Public figures of international organizations |
|
12 |
2,048 |
PEP World |
Foreign public figures |
|
13 |
4,096 |
PEP RelPersons |
Persons connected and related to public figures |
|
14 |
8,192 |
reserve |
|
|
15 |
16,384 |
reserve |
|
|
16 |
32,768 |
Lost Docs |
Lost national and foreign passports |
doc |
17 |
65 536 |
Executive |
Register of executive proceedings |
executive |
18 |
131,072 |
TaxDebtor |
Tax debtors |
TaxDebtor |
19 |
262,144 |
reserve |
|
|
20 |
524,288 |
reserve |
|
|
21 |
1,048,576 |
USR |
Involvement in a legal entity |
edr |
22 |
2,097,152 |
USR info |
Information from the USR on the legal entity |
edrinfo |
23 |
4,194,304 |
USR history |
History of changes in the USR |
|
24 |
8,388,608 |
USR changes (form of incorporation / name) |
USR changes (form of incorporation / name) |
edrchanges |
25 |
16,777,216 |
USR changes (address) |
USR changes (address) |
|
26 |
33,554,432 |
USR changes (manager) |
USR changes (manager) |
|
27 |
67,108,864 |
USR changes (NACE) |
USR changes (NACE) |
|
28 |
134,217,728 |
USR changes (status) |
USR changes (status) |
|
29 |
268,435,456 |
USR changes (UBO) |
USR changes (UBO) |
|
30 |
536,870,912 |
USR changes (owner) |
USR changes (owner) |
|
31 |
1,073,741,824 |
Justice |
Legal proceedings |
justice |
32 |
2,147,483,648 |
License |
Licenses (construction and issue of securities) |
license |
33 |
4,294,967,296 |
reserve |
|
|
34 |
8,589,934,592 |
reserve |
|
|
35 |
17,179,869,184 |
reserve |
|
|
Example of initial request:
{
“IDinternal” : 12005,
“DateRequest” : “2020-03-10 12:27:41”,
“IDsubjectFM” : "login", “tokken” : "sdfg89dfg6dfgy8fdg", “IDuserPC” : 34,
“name” : “ШЕІН АНДРІЙ БОРИСОВИЧ”, “namelat” : “SHEIN ANDRIY BORYSOVYCH”, “date” : “1971-07-15”,
“city” : “Київ”, “doc” : null, “listdata” : 127,
“search” : 1, “finmon” : false, “responsetype” : 3
}
Examples of API request application:
in URL (GET method):
https://finap.com.ua:9443/api?IDinternal=1&IDsubjectFM=test&IDuserPC=1&name=Азаров Микола Янович&listdata=5759&tokken=9T60bVZ70TenNJDwUjX4HQ==
in HTTP (GET):
GET /api?IDinternal=1&IDsubjectFM=test&IDuserPC=1&name=Азаров Микола Янович&listdata=5759&tokken=9T60bVZ70TenNJDwUjX4HQ== HTTP/1.1 Host: finap.com.ua:9999
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW
----WebKitFormBoundary7MA4YWxkTrZu0gW
in Java — OkHttp (POST):
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("text/plain");
MediaType JSON = MediaType.parse("application/json; charset=utf-8"); RequestBody body = RequestBody.create(JSON, "{}");
Request request = new Request.Builder()
.url("http://finap.com.ua:9999/api?IDinternal=1&IDsubjectFM=test&IDuserPC=1&name=Азаров Микола Янович&listdata=5759&tokken=9T60bVZ70TenNJDwUjX4HQ==")
.method("POST", body)
.build();
Response response = client.newCall(request).execute();
Name |
Type of value |
Description of the ‘name/value’ pair |
IDinternal |
тumeric* |
Internal unique request ID (generated by the reporting entity’s internal software means) |
IDsubjectFM |
numeric* |
Reporting entity ID (assigned at registration of the reporting entity in the ‘FinAP CheckLists’ PC) |
IDuserPC |
numeric* |
The workplace ID of the reporting entity (assigned when registering the workplaces of the reporting entity in the ‘FinAP CheckLists’ PC) |
IDrequest |
numeric* |
Request ID in the ‘FinAP CheckLists’ PC (generated by the Request Processing Service means) |
DateResponse |
datetime* |
Date and time of response generation (generated by the Request Processing Service means) in the ‘YYYY-MM-DD hh:mm:ss’ format |
listdata |
numeric* |
The number that, when converted to binary format, reflects the data lists in which the data matches were searched for, see Table 2 |
search |
numeric** |
Search method (1 — fulltext, 2 — contextual...) |
response |
numeric** |
Type of response (request result): 1 — permission response (true|false); 2 — generalized; 3 — short; 5 — full; |
textformat |
string** |
text field format for the full response type (responsetype=5); it can be set to ‘JSON’ (or ‘ ’, by default), ‘xml’, ‘html’, and ‘text’ |
Result |
the results of request processing in the ‘Result’ JSON object (see Table 4–9) |
* — required sets of ‘name/value’ pairs
** — reserved sets of pairs that are not currently used; the value is set to ‘default’
Description of the ‘tag’ pair parameters: API response ‘value’ (JSON) of the Check√Lists FinAP API service
Parameter |
Example |
Description |
|
TITLE API response |
|||
idinternal |
"idinternal": "999", |
Internal unique request ID (generated by the reporting entity’s internal software means) |
|
idsubjectF |
"idsubjectFM": "ARX", |
Reporting entity ID (assigned when registering a reporting entity in the ‘FinAP CheckLists’ PC) |
|
iduserPC |
"iduserPC": "arx", |
The workplace ID of the reporting entity (assigned when registering the workplaces of the reporting entity in the ‘FinAP CheckLists’ PC) |
|
idrequest |
"idrequest": "4239", |
Request ID in the ‘FinAP CheckLists’ PC (generated by the Request Processing Service means) |
|
dateResponse |
"dateResponse": "2020-10-29T10:55:38.116", |
Date and time of response generation (generated by the Request Processing Service means) in the ‘YYYY-MM-DD hh:mm:ss’ format |
|
listdata |
"listdata": "-1", |
The number that, when converted to binary format, reflects the data lists in which the data matches were searched for, see Table 2 |
|
search |
"search": "1", |
Search method (1 — fulltext, 2 — contextual...) |
|
responsetype |
"responsetype": "1", |
Type
of response (request result): |
|
textformat |
"textformat": "", |
text field format for the full response type (responsetype=5); it can be set to ‘JSON’ (or ‘ ’, by default), ‘xml’, ‘html’, and ‘text’ |
|
result |
"result": { |
Result data array |
|
level |
level: "Низький" |
Level of correspondence in the Registers of “Public figures” |
|
list |
"list": "pep", |
Search registry name (‘pep’) |
|
idpep |
"idpep": 2293, |
PEP ID in FinAP |
|
name |
"name": "Кличко Віталій Володимирович", |
PEP’s full name |
|
dateb |
"dateb": "1971-07-19", |
PEP’s date of birth |
|
job |
"job": "Керівники політичних партій", |
PEP’s position |
|
region |
"region": "м. Київ", |
Region of activity (of national public figures) |
|
ipn |
"ipn": "", |
PEP’s TIN |
|
photo |
"photo": "http://storage.finap.com.ua/source/pepman/p0000002293.jpg", |
PEP’s photo |
|
categoryPEP |
"categoryPEP": "Національні публічні діячі", |
Categories to which the PEP belongs according to K019 NBU Reference Book |
|
typePEP |
" typePEP ":0 |
Numerical value of the PEP’s general category (0 — individual public figures who perform prominent public functions; 1 — CONNECTED PERSON; 2 — RELATED PERSON; 3 — individual public figures who performed prominent public functions) |
|
descriptiontypePEP |
"descriptiontypePEP": "1, 5" |
Numerical values of the categories to which the PEP belongs according to K019 NBU Reference Book |
|
declarations |
"declarations": [ |
Declarations data array |
|
d_name |
"d_name": "Виправлена декларація (щорічна)", |
Declaration name |
|
d_year |
"d_year": "2019", |
Declaration year |
|
d_link |
"d_link": "https://public.nazk.gov.ua/declaration/873f4ae3-d7f6-45c0-bc28-fda9986049cd", |
Link to the declaration on the NACP website |
|
d_pdf |
"d_pdf": "http://storage.finap.com.ua/source/pepman/0000115426.pdf" |
Link to the declaration in PDF format on the FinAP website |
|
jobdetails |
"jobdetails": [ |
Job Information data array |
|
jobplace |
"jobplace": "Київська міська державна адміністрація", |
Name of place of work |
|
jobbegin |
"jobbegin": "2014-06-05", |
Start date at the position |
|
jobend |
"jobend": null, |
Date of completion of work at the position |
|
jobpost |
"jobpost": "Міський голова", |
Position |
|
jobedrpou |
"jobedrpou": "00022527", |
USREOU code of the place of work |
|
links |
"links": [ |
Links to Job Information Sources data array |
|
site |
"site": "https://kievcity.gov.ua/content/klychko-vitaliy-volodymyrovych.html", |
Link to official source |
|
|
"pdf": "http://storage.finap.com.ua/source/pepman/0000001859.pdf", |
Link to PDF file on FinAP website (404) |
|
brief |
"brief": "Кличко Віталій Володимирович, Київ. міський голова (з 05.06.2014)" |
Link description |
|
relatedPersons |
"relatedPersons": [ |
Related Persons data array |
|
relatepib |
"relatepib": "БЛАГОДІЙНА ОРГАНІЗАЦІЯ \"БЛАГОДІЙНИЙ ФОНД\" МАЙБУТНІЙ КИЇВ \"", |
Related person name / full name |
|
relatebrief |
"relatebrief": "Бенефіціарний власник", |
Relation type |
|
relatecod |
"relatecod": "39365432" |
Related person code |
|
relatedPeps |
"relatedPeps": [ |
PEP Relation data array |
|
briefrpep |
"briefrpep": "дочка", |
PEP relation |
|
photorpep |
"photorpep": "https://storage.finap.com.ua/source/pepman/p0000002293.jpg", |
Link to PEP’s photo on the FinAP website |
|
namerpep |
"namerpep": "Кличко Віталій Володимирович", |
PEP’s full name |
|
jobrpep |
"jobrpep": "Керівники політичних партій", |
PEP’s position |
|
categoryrpep |
"categoryrpep": "НАЦІОНАЛЬНИЙ ПУБЛІЧНИЙ ДІЯЧ", |
PEP’s category |
|
links |
"links": [ |
Sources data array |
|
site |
"site": "https://public.nazk.gov.ua/declaration/c1e28633-8f08-48fe-aa2c-9c9e2d79eea6", |
Link to official source |
|
|
"pdf": "https://storage.finap.com.ua/source/pepman/0000127825.pdf", |
Link to PDF file on FinAP website |
|
brief |
"brief": "Виправлена декларація (після звільнення) за 2019" |
Link description |
|
sanctions |
"sanctions": [ |
||
sanctionId |
"sanctionId": "РНБО.14311", |
Person ID in the sanction lists |
|
list |
"list": "РНБО", |
Name of the sanction list |
|
level |
level: "Низький" |
Level of correspondence in the Registers of "Sanction lists " |
|
name |
"name": "Демченко Іван Іванович", |
Person’s full name or name |
|
address |
"address": "", |
Person’s address |
|
doc |
"doc": " ", |
Identity document: name and/or number or issuing authority; and/or identification code of the person (unstructured field) |
|
birthdayDate |
"birthdayDate": "1960 09 27", |
Person’s date of birth |
|
aka |
"aka": "#Демченко Іван Іванович,#Демченко Иван Иванович,#Демченко Иван Иванович", |
Aliases separated by ‘,#’ |
|
birthdayPlace |
"birthdayPlace": "", |
Person’s place of birth |
|
citizenship |
"citizenship": "", |
Person’s citizenship |
|
entityType |
"entityType": "ПЕРСОНАЛЬНІ", |
Type of sanctions |
|
gender |
"gender": "", |
Person’s gender |
|
insertDate |
"insertDate": "2018-05-14", |
Date of inclusion in the sanction list |
|
lastModifyDate |
"lastModifyDate": "2020-02-12", |
Date of last change in the sanction list |
|
nationality |
"nationality": "Російська Федерація", |
Nationality |
|
originalName |
"originalName": "", |
Original name (at birth) |
|
position |
"position": "", |
Position |
|
remark |
"remark": "1065. Демченко Іван Іванович (Демченко Иван Иванович), народився 27 вересня 1960 р. у ст. Архонська, Північно- Осетинська АРСР, громадянин РФ, може використовувати паспорти 620113751, 640341513, 100094292, дипломатичний паспорт 100117959, депутат Державної думи РФ VI скликання (2011–2016 роки).\n1) відмова в наданні та скасування віз резидентам іноземних держав, застосування інших заборон в’їзду на територію України;\n2) блокування активів – тимчасове обмеження права особи користуватися та розпоряджатися належним їй майном;\n3) запобігання виведенню капіталів за межі України;\n4) інші санкції, що відповідають принципам їх застосування, встановленим Законом. Безстроково.", |
Description of the person |
|
source |
"source": "Санкції активні. Термін безстроковий.", |
Source of sanctions |
|
title |
"title": "", |
Title, rank |
|
vessel |
"vessel": "", |
Information about vessels (water transport) |
|
work |
"work": "", |
Job information |
|
percent |
"percent": 47 |
Relevance, % |
|
sanctionSource |
"sanctionSource": { |
Information
about the source from which |
|
norder |
"norder": "Указ Президента України №64/2021 від 19.02.2021 року." |
Document title |
|
dateorder |
"dateorder": "2021-02-19" |
Document date |
|
weblink |
"weblink": https://www.president.gov.ua/documents/642021-36753 |
Link to the document |
|
edr |
"edr": [ |
in LEs data array |
|
edrpou |
"edrpou": "26410014", |
LE USREOU code |
|
name |
"name": "БЛАГОДІЙНА ОРГАНІЗАЦІЯ БЛАГОДІЙНИЙ ФОНД ФОНД КЛИЧКО", |
Name of LE |
|
shortname |
"shortname": "БО БЛАГОДІЙНИЙ ФОНД ФОНД КЛИЧКО", |
Abbreviated name of LE |
|
address |
"address": "УКРАЇНА, 01001, МІСТО КИЇВ, ВУЛИЦЯ ХРЕЩАТИК, БУДИНОК 48-Б", |
Address of LE |
|
manager |
"manager": "НОСЕНКО АЛІНА СЕРГІЇВНА", |
Full name of the LE manager |
|
manager |
"kved": "88.99 НАДАННЯ ІНШОЇ СОЦІАЛЬНОЇ ДОПОМОГИ БЕЗ ЗАБЕЗПЕЧЕННЯ ПРОЖИВАННЯ, Н. В. І. У.", |
The main NACE code of LE |
|
state |
"state": "ЗАРЕЄСТРОВАНО", |
Status of LE, possible values: ‘REGISTERED’, ‘REGISTERED, CERTIFICATE OF STATE REGISTRATION INVALID’, ‘BANKRUPTCY (SANITATION) CASE INITIATED’, ‘BANKRUPTCY CASE INITIATED’, ‘UNDER DISSOLUTION’, ‘DISSOLVED’ |
|
txtf |
"txtf": "КЛИЧКО ВІТАЛІЙ ВОЛОДИМИРОВИЧ, РОЗМІР ЧАСТКИ - 0,00 ГРН.", |
Full original (unstructured) text of the FOUNDER field (information about UBO/founder/member) from the USR |
|
kbv |
"kbv": "1", |
The person being an UBO in the LE (0 or 1) |
|
mng |
"mng": "0", |
The person being a manager in the LE (0 or 1) |
|
own |
"own": "1" |
The person being a member in the LE (0 or 1) |
|
edrinfo |
"edrinfo": [ { |
||
edrpou |
"edrpou": "37789993", |
LE USREOU code |
|
name |
"name": "БЛАГОДІЙНИЙ ФОНД ОЛЕКСАНДР ЯНУКОВИЧ", |
Name of LE |
|
name |
"shortname": "БФ ОЛЕКСАНДР ЯНУКОВИЧ", |
Abbreviated name of LE |
|
address |
"address": "УКРАЇНА, 83015, ДОНЕЦЬКА ОБЛ., МІСТО ДОНЕЦЬК, ПРОСПЕКТ БОГДАНА ХМЕЛЬНИЦЬКОГО, БУДИНОК 102", |
Address of LE |
|
manager |
"manager": "КУЗНЕЦОВ ВОЛОДИМИР ОЛЕКСАНДРОВИЧ", |
Manager of LE |
|
kved |
"kved": "88.99 НАДАННЯ ІНШОЇ СОЦІАЛЬНОЇ ДОПОМОГИ БЕЗ ЗАБЕЗПЕЧЕННЯ ПРОЖИВАННЯ, Н. В. І. У.", |
The main NACE code of LE |
|
state |
"state": "ЗАРЕЄСТРОВАНО", |
Status of LE, possible values: ‘REGISTERED’, ‘REGISTERED, CERTIFICATE OF STATE REGISTRATION INVALID’, ‘BANKRUPTCY (SANITATION) CASE INITIATED’, ‘BANKRUPTCY CASE INITIATED’, ‘UNDER DISSOLUTION’, ‘DISSOLVED’ |
|
m_pep |
"m_pep": "0", |
Involvement of the manager in PEPs (number of matches in Check√Lists) |
|
m_san |
"m_san": "0", |
Presence of the manager in sanction lists / terrorist lists (number of matches in Check√Lists) |
|
founders |
"founders": [ |
||
founder |
"founder": "КІНЦЕВИЙ БЕНЕФІЦІАРНИЙ ВЛАСНИК (КОНТРОЛЕР) - ЯНУКОВИЧ ОЛЕКСАНДР ВІКТОРОВИЧ, УКРАЇНА, 83047, ДОНЕЦЬКА ОБЛ., МІСТО ДОНЕЦЬК, ВУЛИЦЯ РАЙНІСА, БУДИНОК 65Д.", |
Information from the USR |
|
pib_name |
"pib_name": "ЯНУКОВИЧ ОЛЕКСАНДР ВІКТОРОВИЧ", |
Full name or name of UBO/founder/member |
|
kbv |
"kbv": "ТАК", |
Information about UBO? (0 or 1) |
|
typecl |
"typecl": "фізична особа", |
Type of UBO/founder/member — I or LE. What values can it take? |
|
n_pep |
"n_pep": "1", |
Involvement of UBO/founder/member in PEPs (number of matches in Check√Lists) |
|
n_san |
"n_san": "3" |
Presence of UBO/founder/member in sanction lists / terrorist lists (number of matches in Check√Lists) |
|
taxdebtor |
"taxdebtor": [ { |
Tax Debtors data array |
|
dname |
"dname": "ТОВАРИСТВО З ОБМЕЖЕНОЮ ВIДПОВIДАЛЬНIСТЮ \"СУМАТРА - ЛТД\"", |
Debtor name |
|
dedrpou |
"dedrpou": "21591206", |
Debtor USREOU code |
|
ddirname |
"ddirname": "ШЕЙКО ГЕОРГІЙ МИХАЙЛОВИЧ", |
Full name of the debtor’s manager |
|
dfs |
"dfs": [ { |
STS Units data array |
|
ddfsname |
"ddfsname": "ОФІС ВЕЛИКИХ ПЛАТНИКІВ ПОДАТКІВ ДПС", |
Name of the STS unit |
|
debtdetails |
"debtdetails": [ |
Debt Obligation Details data array
|
|
dminperiod |
"dminperiod": 201910, |
At the beginning of the reporting period |
|
dmaxperiod |
"dmaxperiod": 201910, |
At the end of the reporting period |
|
dsumlocal |
"dsumlocal": 0, |
Amount of debt to the local budget, UAH |
|
dsumgov |
"dsumgov": 13929258, |
Amount of debt to the state budget, UAH |
|
dsumesv |
"dsumesv": 4857544 |
Amount of unified social tax debt, UAH |
|
disactive |
"disactive": 0 |
Tax debt existence according to the latest data (0 or 1) |
|
edrchanges |
"edrchanges": [ { |
||
edrchangesfrom |
"edrchangesfrom": "2019-03-20", |
Start date of the period under review |
|
edrchangesto |
"edrchangesto": "2020-04-10", |
End date of the period under review |
|
edrchanges |
"edrchanges": [ { |
||
edrpou |
"edrpou": "16285602", |
USREOU code |
|
lastname |
"lastname": "АКЦІОНЕРНЕ ТОВАРИСТВО СТРАХОВА КОМПАНІЯ ІНГО", |
Person’s name |
|
lastsname |
"lastsname": "АТ СК ІНГО", |
Person’s short name |
|
lastaddress |
"lastaddress": "УКРАЇНА, 01054, МІСТО КИЇВ, ВУЛИЦЯ БУЛЬВАРНО-КУДРЯВСЬКА, БУДИНОК 33", |
Person’s address |
|
laststate |
"laststate": "ЗАРЕЄСТРОВАНО", |
Person’s status. The values it can take |
|
n_name |
"n_name": "2", |
Number of name changes (form of incorporation) |
|
n_address |
"n_address": "0", |
Number of address changes |
|
n_manag |
"n_manag": "0", |
Number of changes of managers |
|
n_kved |
"n_kved": "0", |
Number of changes in the primary activity |
|
n_state |
"n_state": "0", |
Number of changes in the status of the LE |
|
n_kbv |
"n_kbv": "0", |
Number of UBO changes |
|
n_founder |
"n_founder": "0", |
Number of changes of founders / members |
|
changes |
"changes": [ { |
What has been Changed data array |
|
datachange |
"datachange": "2020-04-01", |
Date of change |
|
changedetails |
"changedetails": [ |
Details of Changes data array |
|
changeinf |
"changeinf": "010. зміна органіційно-правової форми або назви", |
Change information |
|
oldv |
"oldv": "ПРИВАТНЕ АКЦІОНЕРНЕ ТОВАРИСТВО АКЦІОНЕРНА СТРАХОВА КОМПАНІЯ ІНГО УКРАЇНА", |
Old value |
|
newv |
"newv": "АКЦІОНЕРНЕ ТОВАРИСТВО СТРАХОВА КОМПАНІЯ ІНГО" |
New value |
|
lostdocs |
"lostdocs": [ { |
Lost Documents data array |
|
ovd |
"ovd": "МІНІСТЕРСТВО ВНУТРІШНІХ СПРАВ", |
The unit which entered the information in the register of lost / stolen documents |
|
d_SERIES |
"d_SERIES": "ET", |
Document series |
|
d_NUMBER |
"d_NUMBER": "403566", |
Document No |
|
d_TYPE |
"d_TYPE": "ПАСПОРТ ГРОМАДЯНИНА УКРАЇНИ", |
PASSPORT OF A CITIZEN OF UKRAINE’, ‘PASSPORT OF A CITIZEN OF UKRAINE FOR TRAVELLING ABROAD’, ‘CREW MEMBER CERTIFICATE’ |
|
d_STATUS |
"d_STATUS": "ВИЗНАНО НЕДІЙСНИМ", |
Document status, possible values: ‘RECOGNIZED INVALID’, ‘STOLEN’, ‘LOST’, ‘PASSPORT OF THE DEAD NOT HANDED OVER TO THE SMSU’ |
|
theft_DATA |
"theft_DATA": "2014-04-03", |
Date of notification of loss / theft |
|
insert_DATE |
"insert_DATE": "2014-04-29", |
Date of entry in the register of lost documents |
|
id |
"id": "0014119751696004" |
Lost document record ID |
|
licenses |
"licenses": [ { |
Licences data array |
|
edrpou |
"edrpou": "21591206", |
USREOU code / TIN |
|
build |
"build": [ { |
Construction Licences data array |
|
id |
"id": 2013045588, |
Licence ID |
|
vud |
"vud": "Отримання ліцензії", |
Licence type |
|
lic |
"lic":"АЕ 180205", |
Licence number |
|
name |
"name" : "ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ \"СПЕЦІАЛІЗОВАНЕ БУДІВЕЛЬНО- МОНТАЖНЕ ПІДПРИЄМСТВО \"ЕНЕРГОТЕПЛОМОНТАЖ\"", |
Name |
|
address |
"address" : "Сумська обл., м. Суми, пл. ПРИВОКЗАЛЬНА, будинок 9", |
Address |
|
datebegin |
"datebegin": "2017-12-13", |
Date of licence issue |
|
dateend |
"dateend": "2100-01-01" |
Licence expiration date |
|
bonds |
"bonds": [{ |
Securities data array |
|
id |
"id": 2013045588, |
Securities ID |
|
sertificates_nom |
"sertificates_nom": "01,02/10/1/06", |
Number of certificate of issue registration |
|
edrpou |
"edrpou" : "12345678", |
Issuer’s USREOU code |
|
entity_form |
"entity_form" : "ТОВ", |
Issuer’s form of incorporation |
|
name |
"name" : "РОМАШКА", |
Name of issuer |
|
emis_type_name |
"emis_type_name": "Акції", |
Type of securities (Shares / Bonds) |
|
qty |
"qty" : 100, |
number of securities |
|
nominal |
"nominal": 1000, |
par value |
|
emis_vol |
"emis_vol": 450000, |
total par value of issue |
|
stat_cap |
"stat_cap": 500000, |
amount of authorized capital |
|
releases_form_code |
"releases_form_code": "Д", |
form of existence |
|
tp_name |
"tp_name": "Прості іменні", |
type of securities |
|
reg_date |
"reg_date": "2006-01-27", |
date of registration of securities issue |
|
report_reg_dt |
"report_reg_dt": "2100-01-01", |
date of registration of the report on the securities placement results; |
|
suspend_nom |
"suspend_nom": "Р.№44-КУ-З", |
number of the order to suspend circulation |
|
suspend_dt |
"suspend_dt": "2009-10-13", |
date of issue of the order on suspension of circulation; |
|
resume_nom |
"resume_nom": "", |
number of the order on resumption of circulation; |
|
resume_dt |
"resume_dt" : "2010-01-01", |
date of issue of the order on resumption of circulation; |
|
cancel_nom |
"cancel_nom": "", |
number of the order on cancellation of registration of the issue; |
|
cancel_dt |
"cancel_dt" : "2010-10-10", |
date of issue of the order on cancellation of registration of the issue; |
|
series |
"series": "" |
bond issue series (if any). |
|
gambling |
"gambling": [{ |
An
array of data on licences for |
|
name |
"name": "ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ «СОЛО ГЕЙМС»" |
NAME OF LEGAL ENTITY |
|
address |
"address": "49000, місто Дніпро, проспект Яворницького Дмитра, буд. 60, офіс 502" |
LOCATION |
|
license |
"license": "31.05.2021 № 313" |
DECISION ON GRANTING A LICENCE (date of adoption, decision number) |
|
datelicense |
"datelicense": "2021-06-04" |
DATE OF LICENCE ISSUE |
|
brandname |
"brandname": "FIRST RAY" |
GAMBLING ORGANIZER BRAND |
|
ntypelic |
"ntypelic": 3 |
Digital code of the licence type: (1 — ‘online casino gambling organization and carrying out activities licence’; 2 — ‘casino gambling facilities gambling organization and carrying out activities licence’; 3 — ‘slot halls gambling organization and carrying out activities licence’; 4 — ‘online poker gambling organization and carrying out activities licence’; 5 — ‘bookmaking activities organization and carrying out licence’) |
|
typelic |
"typelic": "ліцензія на провадження діяльності з організації та проведення азартних ігор у залах гральних автоматів" |
Licence type |
|
description |
"description": "61001, м. Харків, вул. Молочна, буд. 14а (перший поверх готелю «КІРОФФ»), загальною полощею 300,8 квадратних метрів);33028, м. Рівне, вул. Соборна, буд. 112 (другий поверх готелю «Україна»), загальною площею 410 квадратних метрів); 79007, м. Львів, вул. Городоцька, буд.15 (підвальний поверх готелю «АСТОРІЯ»), загальною площею 303,1 квадратних метрів) " |
PLACE OF BUSINESS OF THE LICENSEE (location of the gambling facility (address) and area of the gambling facility) |
|
bonds |
"bonds": [{ |
Array of data on court decisions |
|
cause_num |
"cause_num": "916/3625/20", |
Court case number |
|
typeperson |
"typeperson": "ПОЗИВАЧ (ЗАЯВНИК)", |
Party to the court case |
|
name |
"name": "Господарське", |
Type of court case |
|
nameperson |
"nameperson": "ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ \"ТЕХСТРОЙ-99\"", |
Person’s name |
|
datails |
"94226540|Господарський суд Одеської області|Перша|Ухвала|Щавинська Ю.М.| підряду|2021-01- 18|http://od.reyestr.court.gov.ua/files/47/22b13557da064e9dedb05540b2546316.rtf;93999097| Господарський суд Одеської області|Перша|Ухвала|Щавинська Ю.М.|підряду|2021-01- 04|http://od.reyestr.court.gov.ua/files/46/9a8fdbfabaa66d25a7eb3ed9379f6af4.rtf;93742168| Господарський суд Одеської області|Перша|Ухвала|Щавинська Ю.М.|підряду|2020-12- 22|http://od.reyestr.court.gov.ua/files/46/27f2a7bcff273ee05b5a90a6ff7f3bdc.rtf" |
Details of the court case |
|
persons |
"ПОЗИВАЧ (ЗАЯВНИК):ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ \"ТЕХСТРОЙ-99\":Господарський суд Одеської області:2021-01-18;ВІДПОВІДАЧ (БОРЖНИК):ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ \"КАМБІО- СТРОЙСЕРВІС\":Господарський суд Одеської області:2021-01-18" |
Parties to the court case |
|
"justice": [{ |
Array of data on court decisions |
||
cause_num |
"cause_num": "916/3625/20", |
Case number/file number |
|
name |
"name": "Господарське" |
Forms of legal proceedings |
|
typeperson |
"typeperson": "ПОЗИВАЧ (ЗАЯВНИК)", |
Types of litigators |
|
nameperson |
"nameperson": "ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ \"ТЕХСТРОЙ-99\"", |
Full name or name of the party in the lawsuit |
|
datails |
"94226540|Господарський суд Одеської області|Перша|Ухвала|Щавинська Ю.М.|підряду|2021-01-18|http://od.reyestr.court.gov.ua/files/47/22b13557da064e9dedb05540b2546316.rtf;93999097|Господарський суд Одеської області|Перша|Ухвала|Щавинська Ю.М.|підряду|2021-01-04|http://od.reyestr.court.gov.ua/files/46/9a8fdbfabaa66d25a7eb3ed9379f6af4.rtf;93742168|Господарський суд Одеської області|Перша|Ухвала|Щавинська Ю.М.|підряду|2020-12-22|http://od.reyestr.court.gov.ua/files/46/27f2a7bcff273ee05b5a90a6ff7f3bdc.rtf" |
Detailed information (case number | court name | court form | court decision form | judge | subject of dispute | decision date | decision reference). Separator between fields "|", separator between several cases ";" |
|
persons |
"ПОЗИВАЧ (ЗАЯВНИК):ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ \"ТЕХСТРОЙ-99\":Господарський суд Одеської області:2021-01-18;ВІДПОВІДАЧ (БОРЖНИК):ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ \"КАМБІО-СТРОЙСЕРВІС\":Господарський суд Одеської області:2021-01-18" |
Party to the trial (type of party: name or NAME: name of the court: date of the hearing). Separator between fields ":", separator between several sides ";" |
|
"executive": [{ |
Array of data on Register of executive proceedings |
||
begindate_vp |
"begindate_vp": "2015-05-15" |
Date of commencement |
|
creditor_edrpou |
""creditor_edrpou": "24607899" |
USREOU creditor code |
|
creditor_name |
"creditor_name": "\"Дніпропетровськгаз\"" |
Name of the lender |
|
debtor_name |
"debtor_name": "Іванов Іван Іванович" |
Name of the debtor |
|
depname |
"depname": "Нікопольський міськрайонний відділ державної виконавчої служби Головного територіального управління юстиціїї у Дніпропетровській області" |
Name of the Executive Service |
|
order_vp |
"order_vp": 47612693 |
Proceedings number |
|
state_vp |
"state_vp": "Завершено" |
Status of proceeding |
|
typecl |
"typecl": "боржник" |
Status |
2.1 Parameters of the API response (list of ‘name/value’ pairs) by search results in the ‘Public Figures’ (pep) database:
Example of the API response based on search results in the ‘Public Figures’ (pep) database in JSON format:
{
iDinternal": "1",
"iDsubjectFM": "finap",
"iDuserPC": "user",
"iDrequest": "68325",
"dateResponse": "2020-07-21T11:50:51.654",
"listdata": "-1",
"search": "1",
"responsetype": "5",
"textformat": "",
"result": {
...
"peps": [
{
"level": "Низький"
"list": "pep",
"name": "Ляшко Олег Валерійович",
"dateb": "1972-12-03",
"job": "Керівники політичних партій",
"region": "м. Київ",
"ipn": "",
"photo": "http://storage.finap.com.ua/source/pepman/p0000003154.jpg",
"categoryPEP": "Національний публічний діяч",
"jobdetails": [
{
"jobplace": "Верховна Рада України",
"jobbegin": "2014-11-27",
"jobend": "2019-08-29",
"jobpost": "Народний депутат України VIII скликання",
"jobedrpou": "",
"links": [
{
"site": "http://itd.rada.gov.ua/mps/info/page/8818",
"pdf": "http://storage.finap.com.ua/source/pepman/0000002289.pdf",
"brief": "Ляшко Олег Валерійович; ВР України, голова фракції Радикальної партії Олега Ляшка (з 11.2014)"
},
{
"site": "https://public.nazk.gov.ua/storage/documents/pdf/2/5/5/0/255053cb-6969-40b1-9d77-1a309ab080df.pdf",
"pdf": "http://storage.finap.com.ua/source/pepman/0000033426.pdf",
"brief": "Декларація (щорічна) за 2016 рік"
}
]
},
{
"jobplace": "ПОЛІТИЧНА ПАРТІЯ \"РАДИКАЛЬНА ПАРТІЯ ОЛЕГА ЛЯШКА\"",
"jobbegin": "2011-08-08",
"jobend": null,
"jobpost": "Лідер Партії, Голова Політичної ради",
"jobedrpou": "37279703",
"links": [
{
"site": "https://minjust.gov.ua/m/4561",
"pdf": "http://storage.finap.com.ua/source/pepman/0000068290.pdf",
"brief": " Лідер Партії, Голова Політичної ради; ПОЛІТИЧНА ПАРТІЯ \"РАДИКАЛЬНА ПАРТІЯ ОЛЕГА ЛЯШКА\" "
},
{
"site": "https://minjust.gov.ua/m/ediniy-derjavniy-reestr-yuridichnih-osib-fizichnih-osib-pidpriemtsiv-ta-gromadskih-formuvan",
"pdf": "http://storage.finap.com.ua/source/pepman/0000095448.pdf",
"brief": "ЄДИНИЙ ДЕРЖАВНИЙ РЕЄСТР ЮРИДИЧНИХ ОСІБ, ФІЗИЧНИХ ОСІБ – ПІДПРИЄМЦІВ ТА ГРОМАДСЬКИХ ФОРМУВАНЬ"
},
{
"site": "https://pep.org.ua/media/documents/%D0%A0%D0%9F%D0%9B_2018-08-01.png",
"pdf": "http://storage.finap.com.ua/source/pepman/0000068291.pdf",
"brief": " Ляшко Олег Валерійович"
}
]
}
],
"relatedPersons": [
{
"relatepib": "Авер'янов Олег В'ячеславович",
"relatebrief": "Помічник депутата на громадських засадах",
"relatecod": "28406"
},
{
"relatepib": "Ляшко Росіта Олександрівна",
"relatebrief": "дружина",
"relatecod": ""
},
{
"relatepib": "ПОЛІТИЧНА ПАРТІЯ \"РАДИКАЛЬНА ПАРТІЯ ОЛЕГА ЛЯШКА\"",
"relatebrief": "ВР України, голова фракції Радикальної партії Олега Ляшка (з 11.2014)",
"relatecod": "37279703"
},
{
"relatepib": "ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ ПРИВАТНИЙ ЗАКЛАД ДОШКІЛЬНОЇ ОСВІТИ ВІЛЛА КІДС",
"relatebrief": "Бенефіціар",
"relatecod": "43175762"
},
{
"relatepib": "Цапенко Олексій Васильович",
"relatebrief": "Помічник депутата на громадських засадах",
"relatecod": ""
}
],
"relatedPeps": []
}
],
...
}
}
API response parameters (list of ‘name/value’ pairs) based on search results in the ‘Sanction Lists’ database (sanctions):
Example of API response based on search results in the ‘Sanction Lists’ database (sanctions) in JSON format:
{
"iDinternal": "1",
"iDsubjectFM": "finap",
"iDuserPC": "user",
"iDrequest": "68605",
"dateResponse": "2020-07-21T12:22:07.597",
"listdata": "-1",
"search": "1",
"responsetype": "5",
"textformat": "",
"result": {
...
"sanctions": [
{
"level: "Низький"
"sanctionId": "РНБО.16631",
"list": "РНБО",
"name": "Медведчук Віктор Володимирович",
"address": "місто Київ, вулиця Медвинська, будинок 24",
"doc": "1994214296",
"birthdayDate": "1954 08 07",
"aka": "#Медведчук Віктор Володимирович,#Медведчук Віктор Володимирович,#Медведчук Віктор Володимирович",
"birthdayPlace": "",
"citizenship": "",
"entityType": "ПЕРСОНАЛЬНІ",
"gender": "",
"insertDate": "2021-02-19",
"lastModifyDate": "2021-02-21",
"nationality": "Україна",
"originalName": "",
"position": "",
"remark": "7. Медведчук Віктор Володимирович, 07.08.1954 р.н.,
громадянин України, зареєстрований за адресою: місто Київ, вулиця Медвинська, будинок 24. ІПН - 1994214296.
\n1) блокування активів - тимчасове обмеження права особи користуватися та розпоряджатися належним їй майном;
\n2) обмеження торговельних операцій;
\n3) зупинення виконання економічних та фінансових зобовязань;
\n4) анулювання або зупинення ліцензій та інших дозволів, одержання (наявність) яких є умовою для здійснення
певного виду діяльності, зокрема, анулювання чи зупинення дії спеціальних дозволів на користування надрами;
\n5) повна заборона заходження іноземних невійськових суден та військових кораблів до територіального моря України,
її внутрішніх вод, портів;
\n6) обмеження, часткове чи повне припинення транзиту ресурсів, польотів та перевезень
територією України;
\n7) запобігання виведенню капіталів за межі України;
\n8) заборона участі у приватизації, оренді державного майна
резидентами іноземної держави та особами, які прямо чи опосередковано контролюються резидентами іноземної держави
або діють в їх інтересах;
\n9) заборона видачі дозволів, ліцензій Національного банку України на здійснення інвестицій
в іноземну державу, розміщення валютних цінностей на рахунках і вкладах на території іноземної держави;
\n10) припинення видачі дозволів, ліцензій на ввезення в Україну з іноземної держави чи вивезення з України
валютних цінностей та обмеження видачі готівки за платіжними картками, емітованими резидентами іноземної держави;
\n11) заборона передання технологій, прав на обєкти права інтелектуальної власності;\
\n12) інші санкції, що відповідають принципам їх застосування, встановленим цим Законом."
"source": "Санкції активні. Термін 3 роки.",
"title": "",
"vessel": "",
"work": "",
"percent": 33.0,
"sanctionSource": {
"norder": "Указ Президента України №64/2021 від 19.02.2021 року.",
"dateorder": "2021-02-19",
"weblink": "https://www.president.gov.ua/documents/642021-36753"
}
}
],
...
}
}
API response parameters (list of ‘name/value’ pairs) based on search results in the ‘Lost Documents’ (lostdocs) database:
Example of API response based on search results in the ‘Lost Documents’ (lostdocs) database in JSON format:
{
"iDinternal": "1",
"iDsubjectFM": "finap",
"iDuserPC": "user",
"iDrequest": "68672",
"dateResponse": "2020-07-21T12:29:09.946",
"listdata": "-1",
"search": "1",
"responsetype": "5",
"textformat": "",
"result": {
...
"lostdocs": [
{
"ovd": "МІНІСТЕРСТВО ВНУТРІШНІХ СПРАВ",
"d_SERIES": "ET",
"d_NUMBER": "403566",
"d_TYPE": "ПАСПОРТ ГРОМАДЯНИНА УКРАЇНИ",
"d_STATUS": "ВИЗНАНО НЕДІЙСНИМ",
"theft_DATA": "2014-04-03",
"insert_DATE": "2014-04-29",
"id": "0014119751696004"
}
],
...
}
}
API response parameters (list of ‘name/value’ pairs) based on search results in the ‘State Registers’ database — involvement in a LE (edr):
Example of API response based on search results in the ‘State Registers’ database — involvement in a LE (edr) in JSON format:
{
"iDinternal": "1",
"iDsubjectFM": "finap",
"iDuserPC": "user",
"iDrequest": "68735",
"dateResponse": "2020-07-21T12:36:54.856",
"listdata": "-1",
"search": "1",
"responsetype": "5",
"textformat": "",
"result": {
…
"edr": [
{
"edrpou": "37967910",
"name": "ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ \"МАКО-ТРЕЙДІНГ\"",
"shortname": "ТОВ \"МАКО-ТРЕЙДІНГ\"",
"address": "83015, ДОНЕЦЬКА ОБЛ., МІСТО ДОНЕЦЬК, ВОРОШИЛОВСЬКИЙ РАЙОН, ПРОСПЕКТ БОГДАНА ХМЕЛЬНИЦЬКОГО, БУДИНОК 102",
"manager": "АКІМУШКІНА ОЛЕНА ВІКТОРІВНА",
"kved": "46.71 ОПТОВА ТОРГІВЛЯ ТВЕРДИМ, РІДКИМ, ГАЗОПОДІБНИМ ПАЛИВОМ І ПОДІБНИМИ ПРОДУКТАМИ",
"state": "ЗАРЕЄСТРОВАНО",
"txtf": "ЯНУКОВИЧ ОЛЕКСАНДР ВІКТОРОВИЧ, РОЗМІР ВНЕСКУ ДО СТАТУТНОГО ФОНДУ - 2499500.00 ГРН.",
"kbv": "1",
"mng": "0",
"own": "1"
},
{
"edrpou": "33957191",
"name": "ПРИВАТНЕ АКЦІОНЕРНЕ ТОВАРИСТВО \"КЕПІТЕЛ БІЛДІНГ КОРПОРЕЙШЕН\"",
"shortname": "ПРАТ \"КБК\"",
"address": "84313, ДОНЕЦЬКА ОБЛ., МІСТО КРАМАТОРСЬК, ВУЛИЦЯ ОЛЕКСИ ТИХОГО, БУДИНОК 10, ОФІС 306",
"manager": "АКСЕНЧЕНКО АЛЛА ВОЛОДИМИРІВНА",
"kved": "68.20 НАДАННЯ В ОРЕНДУ Й ЕКСПЛУАТАЦІЮ ВЛАСНОГО ЧИ ОРЕНДОВАНОГО НЕРУХОМОГО МАЙНА",
"state": "ЗАРЕЄСТРОВАНО",
"txtf": "БЕНЕФІЦІАРНИЙ ВЛАСНИК (КОНТРОЛЕР) - ЯНУКОВИЧ ОЛЕКСАНДР ВІКТОРОВИЧ, УКРАЇНА, 83047, ДОНЕЦЬКА ОБЛАСТЬ, М.ДОНЕЦЬК, БУДЬОНІВСЬКИЙ РАЙОН, ВУЛИЦЯ РАЙНІСА БУДИНОК 65
\"Д\"- 96,873%, ОПОСЕРЕДКОВАНИЙ ТИП БЕНЕФІЦІАРНОГО ВОЛОДІННЯ (ВОЛОДІЄ 100% СТАТУТНОГО КАПІТАЛУ ПРАТ \"МАКО ХОЛДІНГ\", ПРАТ \"МАКО ХОЛДІНГ\" ВОЛОДІЄ 96,873% СТАТУТНОГО КАПІТАЛУ
ПРАТ \"КЕПІТЕЛ БІЛДІНГ КОРПОРЕЙШЕН\"., РОЗМІР ВНЕСКУ ДО СТАТУТНОГО ФОНДУ - 0.00 ГРН.",
"kbv": "1",
"mng": "0",
"own": "0"
}
],
…
}
}
API response parameters (list of ‘name/value’ pairs) based on search results in the ‘State Registers’ database — information about a LE (edrinfo):
Example of API response based on search results in the ‘State Registers’ database — information about a LE (edrinfo) in JSON format:
{
"iDinternal": "1",
"iDsubjectFM": "finap",
"iDuserPC": "user",
"iDrequest": "68735",
"dateResponse": "2020-07-21T12:36:54.856",
"listdata": "-1",
"search": "1",
"responsetype": "5",
"textformat": "",
"result": {
…
"edrinfo": [
{
"edrpou": "37789993",
"name": "БЛАГОДІЙНИЙ ФОНД \"ОЛЕКСАНДР ЯНУКОВИЧ\"",
"shortname": "БФ \"ОЛЕКСАНДР ЯНУКОВИЧ\"",
"address": "83015, ДОНЕЦЬКА ОБЛ., МІСТО ДОНЕЦЬК, ВОРОШИЛОВСЬКИЙ РАЙОН, ПРОСПЕКТ БОГДАНА ХМЕЛЬНИЦЬКОГО, БУДИНОК 102",
"manager": "КУЗНЕЦОВ ВОЛОДИМИР ОЛЕКСАНДРОВИЧ",
"kved": "88.99 НАДАННЯ ІНШОЇ СОЦІАЛЬНОЇ ДОПОМОГИ БЕЗ ЗАБЕЗПЕЧЕННЯ ПРОЖИВАННЯ, Н. В. І. У.",
"state": "ЗАРЕЄСТРОВАНО",
"m_pep": "0",
"m_san": "0",
"founders": [
{
"founder": "КІНЦЕВИЙ БЕНЕФІЦІАРНИЙ ВЛАСНИК (КОНТРОЛЕР) - ЯНУКОВИЧ ОЛЕНА МИКОЛАЇВНА, УКРАЇНА, 83047, ДОНЕЦЬКА ОБЛ., МІСТО ДОНЕЦЬК, ВУЛИЦЯ РАЙНІСА, БУДИНОК 65\"Д\".",
"pib_name": "ЯНУКОВИЧ ОЛЕНА МИКОЛАЇВНА",
"kbv": "ТАК",
"typecl": "фізична особа",
"n_pep": "0",
"n_san": "0"
},
{
"founder": "КІНЦЕВИЙ БЕНЕФІЦІАРНИЙ ВЛАСНИК (КОНТРОЛЕР) - ЯНУКОВИЧ ОЛЕКСАНДР ВІКТОРОВИЧ, УКРАЇНА, 83047, ДОНЕЦЬКА ОБЛ., МІСТО ДОНЕЦЬК, ВУЛИЦЯ РАЙНІСА, БУДИНОК 65\"Д\".",
"pib_name": "ЯНУКОВИЧ ОЛЕКСАНДР ВІКТОРОВИЧ",
"kbv": "ТАК",
"typecl": "фізична особа",
"n_pep": "1",
"n_san": "3"
},
{
"founder": "ЯНУКОВИЧ ОЛЕНА МИКОЛАЇВНА, РОЗМІР ВНЕСКУ ДО СТАТУТНОГО ФОНДУ - 0.00 ГРН.",
"pib_name": "ЯНУКОВИЧ ОЛЕНА МИКОЛАЇВНА",
"kbv": "-",
"typecl": "фізична особа",
"n_pep": "0",
"n_san": "0"
},
{
"founder": "ЯНУКОВИЧ ОЛЕКСАНДР ВІКТОРОВИЧ, РОЗМІР ВНЕСКУ ДО СТАТУТНОГО ФОНДУ - 0.00 ГРН.",
"pib_name": "ЯНУКОВИЧ ОЛЕКСАНДР ВІКТОРОВИЧ",
"kbv": "-",
"typecl": "фізична особа",
"n_pep": "1",
"n_san": "3"
}
]
}
],
...
}
}
API response parameters (list of ‘name/value’ pairs) based on search results in the ‘Analysis of Changes in the USR’ (edrchanges) database:
Example of API response based on search results in the ‘Analysis of Changes in the USR’ (edrchanges) database in JSON format:
{
"iDinternal": "1",
"iDsubjectFM": "finap",
"iDuserPC": "user",
"iDrequest": "68810",
"dateResponse": "2020-07-21T12:46:45.088",
"listdata": "-1",
"search": "1",
"responsetype": "5",
"textformat": "",
"result": {
"peps": [],
"sanctions": [],
"lostdocs": [],
"edr": [],
"edrinfo": [],
"edrchanges": [
{
"edrchangesfrom": "2020-07-19",
"edrchangesto": "2020-07-20",
"edrchanges": [
{
"edrpou": "00185382",
"lastname": "КОМУНАЛЬНЕ ПІДПРИЄМСТВО НОВОВОЛИНСЬКТЕПЛОКОМУНЕНЕРГО НОВОВОЛИНСЬКОЇ МІСЬКОЇ РАДИ",
"lastsname": "КП НОВОВОЛИНСЬКТЕПЛОКОМУНЕНЕРГО",
"lastaddress": "45400, ВОЛИНСЬКА ОБЛ., МІСТО НОВОВОЛИНСЬК, ВУЛИЦЯ СВЯТОГО ВОЛОДИМИРА, БУДИНОК 3",
"laststate": "ЗАРЕЄСТРОВАНО",
"n_name": "0",
"n_address": "0",
"n_manag": "0",
"n_kved": "0",
"n_state": "0",
"n_kbv": "0",
"n_founder": "0",
"changes": [
{
"datachange": null,
"changedetails": [
{
"changeinf": "090. змін у вибраному періоді не виявлено",
"oldv": null,
"newv": null
}
]
}
]
},
{
"edrpou": "00388599",
"lastname": "ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ СІКАФ",
"lastsname": "ТОВ СІКАФ",
"lastaddress": "29000, ХМЕЛЬНИЦЬКА ОБЛ., МІСТО ХМЕЛЬНИЦЬКИЙ, ВУЛИЦЯ КУПРІНА, БУДИНОК 66/1",
"laststate": "ЗАРЕЄСТРОВАНО",
"n_name": "0",
"n_address": "0",
"n_manag": "1",
"n_kved": "0",
"n_state": "0",
"n_kbv": "0",
"n_founder": "0",
"changes": [
{
"datachange": "2020-07-19",
"changedetails": [
{
"changeinf": "030. зміна керівника",
"oldv": "ПОКОРСЬКИЙ ДЕНИС АНАТОЛІЙОВИЧ",
"newv": "ЛУЦИШИН ОЛЕГ МИКОЛАЙОВИЧ"
}
]
}
]
},
{
"edrpou": "00733412",
"lastname": "ВІДДІЛ АГРОПРОМИСЛОВОГО РОЗВИТКУ СМІЛЯНСЬКОЇ РАЙОННОЇ ДЕРЖАВНОЇ АДМІНІСТРАЦІЇ",
"lastsname": "ВІДДІЛ АГРОПРОМИСЛОВОГО РОЗВИТКУ СМІЛЯНСЬКОЇ РДА",
"lastaddress": "20741, ЧЕРКАСЬКА ОБЛ., СМІЛЯНСЬКИЙ РАЙОН, СЕЛО СУНКИ, ВУЛИЦЯ ЦЕНТРАЛЬНА, БУДИНОК 6",
"laststate": "ПРИПИНЕНО",
"n_name": "0",
"n_address": "0",
"n_manag": "0",
"n_kved": "0",
"n_state": "1",
"n_kbv": "0",
"n_founder": "0",
"changes": [
{
"datachange": "2020-07-19",
"changedetails": [
{
"changeinf": "050. зміна стану ЮО",
"oldv": "В СТАНІ ПРИПИНЕННЯ",
"newv": "ПРИПИНЕНО"
}
]
}
]
},
{
"edrpou": "43713183",
"lastname": "ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ БІГТВ.ВІДЕО",
"lastsname": "ТОВ БІГТВ.ВІДЕО",
"lastaddress": "04205, М.КИЇВ, ОБОЛОНСЬКИЙ РАЙОН, ВУЛИЦЯ ТИМОШЕНКА МАРШАЛА, БУДИНОК 29, КВАРТИРА 355",
"laststate": "ЗАРЕЄСТРОВАНО",
"n_name": "0",
"n_address": "0",
"n_manag": "0",
"n_kved": "1",
"n_state": "0",
"n_kbv": "0",
"n_founder": "0",
"changes": [
{
"datachange": "2020-07-19",
"changedetails": [
{
"changeinf": "040. зміна основного виду діяльності",
"oldv": "32.99 ВИРОБНИЦТВО ІНШОЇ ПРОДУКЦІЇ, Н. В. І. У.",
"newv": "90.02 ДІЯЛЬНІСТЬ ІЗ ПІДТРИМАННЯ ТЕАТРАЛЬНИХ І КОНЦЕРТНИХ ЗАХОДІВ"
}
]
}
]
},
{
"edrpou": "43664545",
"lastname": "ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ ОПТ-ІНВЕСТ-СИСТЕМА",
"lastsname": "ТОВ ОПТ-ІНВЕСТ-СИСТЕМА",
"lastaddress": "10020, ЖИТОМИРСЬКА ОБЛ., МІСТО ЖИТОМИР, БОГУНСЬКИЙ РАЙОН, ВУЛИЦЯ БОГУНСЬКА, БУДИНОК 4-А",
"laststate": "ЗАРЕЄСТРОВАНО",
"n_name": "0",
"n_address": "0",
"n_manag": "0",
"n_kved": "0",
"n_state": "0",
"n_kbv": "0",
"n_founder": "0",
"changes": [
{
"datachange": null,
"changedetails": [
{
"changeinf": "090. змін у вибраному періоді не виявлено",
"oldv": null,
"newv": null
}
]
}
]
},
{
"edrpou": "42088468",
"lastname": "ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ \"ТЕЙМЕЛ КОМПАНІ\"",
"lastsname": "ТОВ \"ТЕЙМЕЛ КОМПАНІ\"",
"lastaddress": "55001, МИКОЛАЇВСЬКА ОБЛ., МІСТО ЮЖНОУКРАЇНСЬК, ПРОСПЕКТ СОБОРНОСТІ, БУДИНОК 8",
"laststate": "ЗАРЕЄСТРОВАНО",
"n_name": null,
"n_address": null,
"n_manag": null,
"n_kved": null,
"n_state": null,
"n_kbv": "1",
"n_founder": null,
"changes": [
{
"datachange": "2020-06-02",
"changedetails": [
{
"changeinf": "060. зміна кінцевого бенефіціарного власника (контролера) КБВ",
"oldv": "—",
"newv": "КІНЦЕВИЙ БЕНЕФІЦІАРНИЙ ВЛАСНИК (КОНТРОЛЕР) - ТКАЧЕНКО ВЛАДИСЛАВ ІГОРОВИЧ, УКРАЇНА, МІСТО КИЇВ, ВУЛИЦЯ КОСМІЧНА, БУДИНОК 8 Б"
}
]
}
],
...
}
}
API response parameters (list of ‘name/value’ pairs) based on search results in the ‘Licences’ (licenses) database:
Example of API response based on search results in the ‘Licences’ (licenses) database in JSON format:
{
"idinternal": "1617879892666",
"idsubjectFM": "Логін",
"iduserPC": "check.finap.com.ua",
"idrequest": "3376",
"dateResponse": "2021-04-08T11:04:53.221",
"listdata": "2147483648",
"search": "1",
"responsetype": "5",
"textformat": "",
"result": {
......
"licenses": [
{
"edrpou": "21561205",
"build": [
{
"id": 2013006600,
"vud": "Отримання ліцензії",
"lic": "АЕ 280285",
"name": "ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ \"ІНВЕСТБУД-8\"",
"address": "м.Київ, вул. Богдана Хмельницького, 51-Б",
"datebegin": "2013-11-22",
"dateend": "2100-01-01"
},
{
"id": 2012087088,
"vud": "Отримання ліцензії",
"lic": "АД071934",
"name": "ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ \"ІНВЕСТБУД-8\"",
"address": "Київ вул. Богдана Хмельницького, 51-Б",
"datebegin": "2012-08-06",
"dateend": "2013-11-25"
},
................
{
"id": 200812012,
"vud": "Отримання ліцензії",
"lic": "АБ107149",
"name": "ЗАКРИТЕ АКЦІОНЕРНЕ ТОВАРИСТВО \"БУДІНВЕСТ-8\"",
"address": "КИЇВ;ВУЛ.БОГДАНА ХМЕЛЬНИЦЬКОГО, 51-Б",
"datebegin": "2005-08-29",
"dateend": "2010-08-29"
}
],
"bonds": [
{
"sertificates_nom": "484/10/1/10",
"name": "ПрАТ Будінвест-8",
"emis_type_name": "Акції",
"qty": 1900,
"nominal": 10,
"emis_vol": 19000,
"stat_cap": 19000,
"releases_form_code": "Б",
"tp_name": "Прості іменні",
"reg_date": "2010-10-11",
"report_reg_dt": "2100-01-01",
"suspend_nom": "Р.№36-ЦД-З",
"suspend_dt": "2012-05-29",
"resume_nom": "",
"cancel_nom": "Р.№55-ЦД-С-А",
"cancel_d": "2012-08-09",
"series": ""
},
{
"sertificates_nom": "65/10/1/02",
"name": "ПрАТ Будінвест-8",
"emis_type_name": "Акції",
"qty": 1900,
"nominal": 10,
"emis_vol": 19000,
"stat_cap": 19000,
"releases_form_code": "Д",
"tp_name": "Прості іменні",
"reg_date": "2002-03-01",
"report_reg_dt": "2100-01-01",
"suspend_nom": "",
"resume_nom": "",
"cancel_nom": "",
"series": ""
}
]
}
],
}
}
API response parameters (list of ‘name/value’ pairs) based on search results in the ‘Court Decisions’ (licenses) database:
Example of API response based on search results in the ‘Court Decisions’ (justice) database in JSON format:
{
"idinternal": "1617881776738", "idsubjectFM": "finap_valex", "iduserPC": "check.finap.com.ua", "idrequest": "4",
"dateResponse": "2021-04-08T11:36:17.309",
"listdata": "1073741824",
"search": "1",
"responsetype": "5",
"textformat": "", "result": {
"justice": [
{
"cause_num": "904/3368/18", "name": "Господарське", "typeperson": "ПОЗИВАЧ (ЗАЯВНИК)",
"nameperson": "ТОВ \"БУДІНВЕСТ-ДНІПРО\"",
"datails": "92228612|Касаційний господарський суд Верховного Суду|Касаційна|Постанова|Погребняк В.Я.|?|2020-09-10|ht суд Дніпропетровської області|Перша|Ухвала|Первушин Юрій Юрійович|Інші спори|2018-09-24|http://od.reyest
"persons": "ПОЗИВАЧ (ЗАЯВНИК):ПРИВАТНЕ ПІДПРИЄМСТВО \"ЦЕСІЯ\":Касаційний господарський суд:2020-04-09;ПОЗИВАЧ (ЗАЯВН
},
{
"cause_num": "904/3368/18", "name": "Господарське",
"typeperson": "ЗАЯВНИК КАСАЦІЙНОЇ ІНСТАНЦІЇ",
"nameperson": "ТОВ \"БУДІНВЕСТ-ДНІПРО\"",
"datails": "92228612|Касаційний господарський суд Верховного Суду|Касаційна|Постанова|Погребняк В.Я.|?|2020-09-10|ht суд Дніпропетровської області|Перша|Рішення|Первушин Юрій Юрійович|Інші спори|2019-07-29|http://od.reyes
"persons": "ПОЗИВАЧ (ЗАЯВНИК):ПРИВАТНЕ ПІДПРИЄМСТВО \"ЦЕСІЯ\":Касаційний господарський суд:2020-04-09;ПОЗИВАЧ (ЗАЯВН
}
]
}
}
where:
"cause_num" — case number/ file number,
"name" — forms of legal proceedings,
"typeperson" — types of litigators,
"nameperson" – full name or name of the party in the lawsuit,
"datails" - detailed information (case number | court name | court form | court decision form | judge | subject of
dispute | decision date | decision reference). Separator between fields "|", separator between several
cases ";"
"persons" - Party to the trial (type of party: full name or name: name of the court: date of the hearing). Separator
between fields ":", separator between several sides ";"
2.9. Parameters of API-answer (the list of pairs “name/meaning) according to the results of search in database „Register of executive proceedings” (executive):
Example of API-answer according to the results of search in database „Register of executive proceedings” (executive) in JSON format:
"idinternal": "1617881776738",
"idsubjectFM": "логін",
"iduserPC": "check.finap.com.ua",
"idrequest": "4",
"dateResponse": "2020-04-08T11:36:17.309",
"listdata": "1073741824",
"search": "1",
"responsetype": "5",
"textformat": "",
"result": {
"executive": [
"begindate_vp": "2015-05-15"
"creditor_edrpou": "24607899"
"creditor_name": "\"Дніпропетровськгаз\""
"debtor_name": "Іванов Іван Іванович"
"depname": "Нікопольський міськрайонний відділ державної виконавчої служби Головного територіального управління юстиціїї у Дніпропетровській області"
"order_vp": 47612693
"state_vp": "Завершено"
"typecl": "боржник"
]
}
where:
"begindate_vp" - Date of commencement
"creditor_edrpou" - USREOU creditor code
"creditor_name" - Name of the lender
"debtor_name" - Name of the debtor
"depname" - Name of the Executive Service
"order_vp" - Proceedings number
"state_vp" - Status of proceeding
"typecl" - Status
Error handling:
When a customer accesses the CheckLists service via API, there may be situations when the service or search registers used by the service are not available. To properly handle these situations, you have to know the following. In response to the request, the service returns the HTTP status of the response. When analysing it and the structure of the response, one can identify the following situations in the service operation:
HTTP status with a code in the range of 500-599 — CheckLists service is not available or works incorrectly.
HTTP status with a code in the range of 400-499 — CheckLists service is available, but cannot process your request. In the response, instead of the structure described above, the customer will receive the following structure with a description of the error:
error int message
string
List of errors:
message |
error |
The ‘user’ user is missing. |
ACCOUNT_NOTFOUND = 1; |
The ‘IP address’ address is missing in the list of allowed addresses. |
NOT_ALLOW_IP = 2; |
Test (promotional) access: the limit of requests has expired, or the term has expired. |
TEST_ACCESS_END = 3; |
The ‘user’ user is allowed access only through the web resource. |
SITEONLY = 6; |
The start date of using the ‘start date’ service has not yet come. |
ACCOUNT_NOT_ALLOWED_YET = 7; |
The ‘end date’ — the allowed period of using the service has expired. |
ACCOUNT_ACCESS_ENDS = 8; |
The ‘user’ user is blocked. |
ACCOUNT_BLOCKED = 9; |
The ‘user’ user has not confirmed registration. |
ACCOUNT_NOT_CONFIRM = 10; |
The request limit (‘request limit’) has been exhausted. |
ACCOUNT_REQUEST_LIMIT_ENDS = 11; |
The ‘start date’ parameter for checking changes in the USR of LEs and IEs is incorrect |
REQUEST_BEGINDATE_ERROR = 103; |
The ‘end date’ parameter for checking changes in the USR of LEs and IEs is incorrect |
REQUEST_ENDDATE_ERROR = 104; |
The lower-limit parameter of the lowranklimit entry for searching the database of sanction lists is incorrect. |
REQUEST_LOWRANKLIMIT_ERROR = 105; |
HTTP status with code 200 — CheckLists service is available and can process requests from customers. The structure of the response may vary depending on access to search registers.
The search register you are accessing is working; you have access to it; and the request processing does not exceed the time allotted for this; the service always returns the result (the structure is described above, or an empty array in the absence of matches), otherwise, in the response block for this search register, the customer may receive a test message with an error instead of the response structure.
List of such messages and situations in which they appear:
“9000.No connection to the service” — the search register is unavailable, or the service has no connection to it
“9001.Access to the service is prohibited” — access to the search register is prohibited because it is not included in the package of services that you have paid
“9003.Request processing exceeds the allotted time. Please specify the request” — appears when processing of the request to the search register exceeds the time allotted for this purpose
“9004. "No connection to the service database”- occurs when the service that maintains the registry is available, but there is no connection to the registry database