ChekList
FinAP


Description of the CheckLists FinA 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:



Using this search data makes it possible to always check the following:


  1. Affiliation of customers / contractors to national and foreign public figures or related persons

  2. Inclusion in the lists of persons connected with terrorist activities or subject to international sanctions (sanctions lists)

  3. Absence of documents provided by the customer / contractor in the database of lost documents

  4. Reliability of customer data on relation of the customer to business entities where the customer / contractor is the ultimate beneficial owner or founder

  5. 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


CHECKLISTS API 1.0


  1. API request parameters (list of ‘name/value’ pairs in the initial request):


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 (1fulltext (default), 2contextual...)


finmon

boolean**

Sign of confirmation of the request results by the financial monitoring unit of the reporting entity (truerequires confirmation, falsedefault, no confirmation required)


response type

numeric**

type of response (request result): 1permission response (allow); 2generalized (resume); 3short (short); 5full (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 JavaOkHttp (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();




  1. API response header options (list of ‘name/value’ pairs):


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 (1fulltext, 2contextual...)

response

numeric**

Type of response (request result): 1permission response (true|false); 2generalized; 3short; 5full;

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 CheckLists 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 (1fulltext, 2contextual...)

responsetype

"responsetype": "1",

Type of response (request result):
1permission response (true|false); 2generalized; 3short; 5full;

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 (0individual public figures who perform prominent public functions; 1CONNECTED PERSON; 2RELATED PERSON; 3individual 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

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

Links to PEP Relation

Sources data array

site

"site": "https://public.nazk.gov.ua/declaration/c1e28633-8f08-48fe-aa2c-9c9e2d79eea6",

Link to official source

pdf

"pdf": "https://storage.finap.com.ua/source/pepman/0000127825.pdf",

Link to PDF file on FinAP website

brief

"brief": "Виправлена декларація (після звільнення) за 2019"

Link description

sanctions

"sanctions": [

Sanction Lists /
Lists of Terrorists data array

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
information was obtained (concerning the NSDC)

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

State Registers, Involvement

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

State Registers, Information about LE data array

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

Information about UBO, Founders, and Members data array

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/memberI 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": [ {

Changes in the USR on the USREOU Code Array data array

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

Changes in the USR on the
Specific USREOU Code data array

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
gambling organization and carrying out activities

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

"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

"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 ofname/valuepairs) by search results in thePublic Figures’ (pep) database:


Example of the API response based on search results in thePublic 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": []

}

],

...

}

}


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

}

}

],

...

}

}













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

}

],

...

}

}



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

}

],

}

}






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

}

]

}

],

...

}

}


    1. 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 Б"

}

]

}

],

...

}

}


    1. 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": ""

}

]

}

],

}

}





    1. 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



  1. 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:


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;



List of such messages and situations in which they appear: