Пошук юридичних осіб та ФОП по назві, коду, адресі, уповноваженим особам та засновникам

Шукає в реєстрі ЮО та ФОП за заданими параметрами. Є два режими пошуку (mode )

simple: використовується параметр text - слова з нього шукаються в назві або в засновниках та уповноважених персонах.
Вихідне поле match_kind містить інформацію о том в якому виду даних персони знайдено співпадіння та чи було співпадіння з актуальними даними по персоні (якщо було співпадіння і з актуальними даними і з неактуальними - в полі буде зазначено що знайдено в актуальних даних). Можливі значення видів даних: назва ; адреса ; уповноважені ; засновники ; бенефіціари. Якщо відбувався пошук по складним крітеріям - будуть вказани тільки ті стани персони (актуальні або ні) в яких було знайдено повне співпадіння. Наприклад: компанія ТОВ "Стелла" в минулому звалася ТОВ "Ванеса", керував неї весь час директор Петренко Василь. Якщо шукати по рядку "Ванеса Петренко" - буде вказано що співпадіння знайдено по "застарілі: назва, уповноважені"
Параметри name, address, related не використовуються

3param: використовуються параметри name, address, related. Параметр текст не використовується. Знаходяться тільки якщо передані слова в name, address, related присутні у відповідних полях. match_kind містить інформацію чи були знайдені дані історичними
В полі message повертає повідомлення та колір його відображення. Повідомлення буде відображено над результатами пошуку, якщо поле message.text не порожнє.
Якщо рядки для пошуку не заповнені, або заповнені не значущими символами - в полі message - повертає інформацію про це
name_format "full" - повна назва, "short" - коротка назва, "medium" - повна назва із скороченнями (скорочене ОПФ та інші характеристики що не відносяться до назви безпосередньо). За вмовчанням "full"

Вхідні параметри mode, name, address, related, text - застарілі. Якщо передан параметр text_param - всі ці параметри ігноруються
для text_param - елементи масива з однаковими kind не повинні зустрічатись. кожен елемент - це текст котрий потрібно шукати у відповідному полі а саме:
any - в довільному полі; name - в назві персони; addr - в адресі; rel - в уповноважених, засновниках, бенефіціарах; cont - в контактах; boss - уповноважені персони; founder - засновники; benef - бенефіціари

Request

Authorization

Add parameter in query

key

Example:

key: ********************

Body Params application/json

text_param

array [object {2}]

optional

стрктровані параметри пошуку

kind

enum<string>

required

вид пошуку

Allowed values:

anynameaddrrelcont

text

string

required

пошуковий рядок

mode

string

optional

вид пошуку

name

string

optional

слова з назви

address

string

optional

слова з адреси

string

optional

слова з назв засновників або уповноважених персон

text

string

optional

слова для пошуку в режимі simple

limitRecords

integer

optional

повернути рядків

skipRecords

integer

optional

пропустити рядків

personKind

enum<integer>

optional

обмежити пошук за видом особи (1-юр.особи, 2-фіз.особи, 0-усі)

Allowed values:

120

onlyActual

boolean

optional

обмежити пошук тільки не історичними даними

entityStates

string

optional

обмежити пошук персонами що знаходяться в стані згідно переліку (ідентифікатори через ‘,’)

regions

string

optional

обмежити пошук областями згідно переліку (коди через ‘,’)

name_format

enum<string>

optional

форма назви, яку буде повернуто

Allowed values:

fullshortmedium

saveToHistory

boolean

optional

зберегти запит до історії запитів

language

string

optional

3 літ. ISO 639-1

key

string

optional

ключ доступу

Example

{
    "text_param": [
        {
            "kind": "name",
            "text": "Ленінська кузня"
        }
    ],
    "limitRecords": 10,
    "skipRecords": 0,
    "personKind": 0,
    "onlyActual": false,
    "name_format": "medium",
    "saveToHistory": false,
    "language": "ukr"
}

Responses

🟢200Success

application/json

Body

answer

object

required

data

array [object {14}]

required

message

object

required

status

enum<string>

required

Allowed values:

SuccessWarningError

statusCode

integer

required

message

string

optional

Example

{
    "status": "Success",
    "statusCode": 301,
    "message": "",
    "answer": {
        "data": [
            {
                "dbid": "DISJ01fc44b08a",
                "code": "21620391",
                "name": "ТОВ \"ЦЕНТР ГРОМАДСЬКОГО ХАРЧУВАННЯ ЗАВОД \"ЛЕНІНСЬКА КУЗНЯ\"",
                "is_individual": false,
                "state_text": "припинено",
                "state_color": "red",
                "state_id": "3",
                "address": "04080, м.Київ, ВУЛИЦЯ ЮРКІВСЬКА/ФРУНЗЕ, будинок 2-6/32 ЛІТ.А",
                "activity": null,
                "director": "Остолецька Ірина Едуардівна керівник",
                "region_code": "80",
                "region_display_name": "Київ",
                "match_kind": "актуальні: назва",
                "relevanceDate": "2020-08-03 19:25:36.317"
            },
            {
                "dbid": "DISJ01fd4d0bb8",
                "code": "24371818",
                "name": "ДОЧІРНЄ ПІДПРИЄМСТВО \"ЛК-МЕТАЛУРГІЯ\" АКЦІОНЕРНОГО ТОВАРИСТВА \"ЗАВОД \"ЛЕНІНСЬКА КУЗНЯ\"",
                "is_individual": false,
                "state_text": "припинення",
                "state_color": "DarkOrange",
                "state_id": "2",
                "address": "04176, місто Київ, ВУЛИЦЯ ЕЛЕКТРИКІВ, будинок 26",
                "activity": "24.52 Лиття сталі ",
                "director": "Пістун Олександр Дмитрович керівник 09.10.2013",
                "region_code": "80",
                "region_display_name": "Київ",
                "match_kind": "актуальні: назва",
                "relevanceDate": "2023-06-22 01:18:21.523"
            },
            {
                "dbid": "DISJ01fc45c5c6",
                "code": "24569638",
                "name": "ДОЧІРНЄ ПІДПРИЄМСТВО \"ЛІКУВАЛЬНО-ОЗДОРОВЧИЙ КОМПЛЕКС \"КОРАБЕЛЬ\" АКЦІОНЕРНОГО ТОВАРИСТВА \"ЗАВОД \"ЛЕНІНСЬКА КУЗНЯ\"",
                "is_individual": false,
                "state_text": "припинення",
                "state_color": "DarkOrange",
                "state_id": "2",
                "address": "08105, Київська обл., Києво-Святошинський район, село Горенка, ВУЛИЦЯ ЛЕНІНА, будинок 125-А",
                "activity": null,
                "director": "Рожковський Франц Антонович керівник",
                "region_code": "32",
                "region_display_name": "Київська",
                "match_kind": "актуальні: назва",
                "relevanceDate": "2020-05-15 21:42:04.533"
            },
            {
                "dbid": "DISJ01fc4629fe",
                "code": "24723482",
                "name": "\"ЛЕНІНСЬКА КУЗНЯ-ВЕРФ\" ТОВ \"КОНЦЕПТ-ЮКРЕЙН\"",
                "is_individual": false,
                "state_text": "припинення",
                "state_color": "DarkOrange",
                "state_id": "2",
                "address": "04176, м.Київ, ВУЛИЦЯ ЕЛЕКТРИКІВ, будинок 26",
                "activity": "35.11.0 БУДУВАННЯ ТА РЕМОНТ СУДЕН",
                "director": "Каркін Сергій Анатлійович керівник",
                "region_code": "80",
                "region_display_name": "Київ",
                "match_kind": "актуальні: назва",
                "relevanceDate": "2020-05-15 03:46:58.510"
            },
            {
                "dbid": "DISJ01fc1b6a58",
                "code": "30757111",
                "name": "ЗАТ \"ТОРГОВИЙ ДІМ \"ЛЕНІНСЬКА КУЗНЯ\"",
                "is_individual": false,
                "state_text": "припинено",
                "state_color": "red",
                "state_id": "3",
                "address": "04176, м.Київ, ВУЛИЦЯ ЕЛЕКТРИКІВ, будинок 26",
                "activity": "35.11.0 БУДУВАННЯ ТА РЕМОНТ СУДЕН",
                "director": "Веденський Віталій Юрійович керівник",
                "region_code": "80",
                "region_display_name": "Київ",
                "match_kind": "актуальні: назва",
                "relevanceDate": "2020-07-11 23:07:16.060"
            },
            {
                "dbid": "DISJ01fdc551c6",
                "code": "33349738",
                "name": "ТОВ \"ТОРГОВИЙ ДІМ \"ЛЕНІНСЬКА КУЗНЯ\"",
                "is_individual": false,
                "state_text": "припинено",
                "state_color": "red",
                "state_id": "3",
                "address": "04112, м.Київ, ВУЛИЦЯ ОЛЕНИ ТЕЛІГИ, будинок 4",
                "activity": "35.11.0 БУДУВАННЯ ТА РЕМОНТ СУДЕН",
                "director": "Адамкович Микола Миколайович керівник",
                "region_code": "80",
                "region_display_name": "Київ",
                "match_kind": "актуальні: назва",
                "relevanceDate": "2020-04-23 11:35:01.123"
            },
            {
                "dbid": "DISJ01fd450618",
                "code": "03078907",
                "name": "ДОЧІРНЄ ПІДПРИЄМСТВО \"МЕДИЧНО-САНІТАРНА ЧАСТИНА\" ПРИВАТНОГО АКЦІОНЕРНОГО ТОВАРИСТВА \"ЗАВОД \"КУЗНЯ НА РИБАЛЬСЬКОМУ\"",
                "is_individual": false,
                "state_text": "діє",
                "state_color": "green",
                "state_id": "1",
                "address": "04176, місто Київ, ВУЛИЦЯ ЕЛЕКТРИКІВ, будинок 26, корпус 87",
                "activity": "86.21 Загальна медична практика",
                "director": "Лисенко Володимир Олександрович керівник 15.08.2013",
                "region_code": "80",
                "region_display_name": "Київ",
                "match_kind": "застарілі: назва",
                "relevanceDate": "2023-09-16 14:11:07.613"
            },
            {
                "dbid": "DISJ01fd48007d",
                "code": "14312364",
                "name": "ПрАТ \"ЗАВОД \"КУЗНЯ НА РИБАЛЬСЬКОМУ\"",
                "is_individual": false,
                "state_text": "діє",
                "state_color": "green",
                "state_id": "1",
                "address": "04176, місто Київ, ВУЛИЦЯ ЕЛЕКТРИКІВ, будинок 26",
                "activity": "30.11 Будування суден і плавучих конструкцій",
                "director": "Шандра Валерій Олександрович керівник",
                "region_code": "80",
                "region_display_name": "Київ",
                "match_kind": "застарілі: назва",
                "relevanceDate": "2023-10-18 10:14:34.303"
            },
            {
                "dbid": "DISJ01fdff73c7",
                "code": "21713661",
                "name": "ППО ПРИВАТНОГО АКЦІОНЕРНОГО ТОВАРИСТВА \"ЗАВОД \"КУЗНЯ НА РИБАЛЬСЬКОМУ\"",
                "is_individual": false,
                "state_text": "діє",
                "state_color": "green",
                "state_id": "1",
                "address": "04176, м.Київ, ВУЛИЦЯ ЕЛЕКТРИКІВ, будинок 26",
                "activity": "94.20 Діяльність професійних спілок ",
                "director": "Нагіба Лариса Іванівна керівник",
                "region_code": "80",
                "region_display_name": "Київ",
                "match_kind": "застарілі: назва",
                "relevanceDate": "2020-05-26 16:04:30.970"
            },
            {
                "dbid": "DISJ01fd4de822",
                "code": "24930407",
                "name": "ДОЧІРНЄ ПІДПРИЄМСТВО ГРОМАДСЬКОГО ХАРЧУВАННЯ \"ПАРУС\" ПРИВАТНОГО АКЦІОНЕРНОГО ТОВАРИСТВА \"ЗАВОД\" КУЗНЯ НА РИБАЛЬСЬКОМУ\"",
                "is_individual": false,
                "state_text": "діє",
                "state_color": "green",
                "state_id": "1",
                "address": "04176, місто Київ, ВУЛИЦЯ ЕЛЕКТРИКІВ, будинок 26",
                "activity": "56.29 Постачання інших готових страв",
                "director": "Плашкевич Анатолій Васильович керівник",
                "region_code": "80",
                "region_display_name": "Київ",
                "match_kind": "застарілі: назва",
                "relevanceDate": "2023-07-01 13:45:02.513"
            }
        ],
        "message": {
            "text": "",
            "color": "black"
        }
    }
}