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

Шукає в реєстрі ЮО та ФОП, груп ЮО, фіз осіб.
для search_param - елементи масива з однаковими kind не повинні зустрічатись. кожен елемент - це текст котрий потрібно шукати у відповідному полі а саме (поле kind):
any - в довільному полі; name - в назві персони; addr - в адресі; rel - в уповноважених, засновниках, бенефіціарах; cont - в контактах; boss - уповноважені персони; founder - засновники; benef - бенефіціари
якщо є рядки з kind in (addr, relm cont, boss, founder, benef) - ФО та групи юр.осіб не знаходяться.
person_kinds - будуть повернуті тільки вказані типи суб'єктів. Передавати обов'язково.
В полі message повертає повідомлення та колір його відображення.
Якщо рядки для пошуку не заповнені, або заповнені не значущими символами - в полі message - повертає інформацію про це
name_format "full" - повна назва, "short" - коротка назва, "medium" - повна назва із скороченнями (скорочене ОПФ та інші характеристики що не відносяться до назви безпосередньо). За вмовчанням "full"
subject_kind_text - повертає для subject_kind 1,2,3 відповідно Юридична особа, ФОП, Фізична особа, для типу 4 - повертає назву групи (Агрохолдінг, ФПГ …)
restricted - завжди повертає не більше 3 рядків, не білінгується, видає відповідне повідомлення.

Request

Authorization

Add parameter in query

key

Example:

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

Body Params application/json

search_param

array [object {2}]

required

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

kind

enum<string>

required

вид пошуку any/name/addr/rel/cont

Allowed values:

anynameaddrrelcont

text

string

required

рядок пошуку

limit_records

integer

optional

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

skip_records

integer

optional

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

subject_kinds

array[integer]

required

обмежити пошук (1-юр.особи, 2-ФОП, 3-ФО, 4-групи юр.особ)

only_actual

boolean

optional

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

entity_states

array[string]

optional

обмежити пошук персонами що знаходяться в стані згідно переліку

regions

array[string]

optional

обмежити пошук областями згідно переліку

name_format

enum<string>

optional

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

Allowed values:

fullshortmedium

save_to_history

boolean

optional

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

restricted

boolean

optional

обмежений пошук

language

string

optional

3 літ. ISO 639-1

key

string

optional

ключ доступу

Example

{
    "search_param": [
        {
            "kind": "any",
            "text": "Ленінська кузня"
        }
    ],
    "limit_records": 10,
    "skip_records": 0,
    "subject_kinds": [
        1,
        2
    ],
    "only_actual": false,
    "name_format": "short",
    "save_to_history": false,
    "restricted": true,
    "language": "ukr"
}

Responses

🟢200Success

application/json

Body

answer

object

required

data

array [object {15}]

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": "ТОВ \"ЦЕНТР ГРОМАДСЬКОГО ХАРЧУВАННЯ ЗАВОД \"ЛЕНІНСЬКА КУЗНЯ\"",
                "subject_kind": 1,
                "subject_kind_text": "Юридична особа",
                "state_text": "припинено",
                "state_color": "red",
                "state_id": "3",
                "address": "04080, м.Київ, ВУЛИЦЯ ЮРКІВСЬКА/ФРУНЗЕ, будинок 2-6/32 ЛІТ.А",
                "activity": null,
                "director": "Остолецька Ірина Едуардівна керівник",
                "region_code": "80",
                "region_display_name": "Київ",
                "match_kind": "актуальні: назва",
                "relevance_date": "2025-03-14 00:00:00.000"
            },
            {
                "dbid": "DISJ01fd4d0bb8",
                "code": "24371818",
                "name": "ДОЧІРНЄ ПІДПРИЄМСТВО \"ЛК-МЕТАЛУРГІЯ\" АКЦІОНЕРНОГО ТОВАРИСТВА \"ЗАВОД \"ЛЕНІНСЬКА КУЗНЯ\"",
                "subject_kind": 1,
                "subject_kind_text": "Юридична особа",
                "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": "актуальні: назва",
                "relevance_date": "2025-03-14 00:00:00.000"
            },
            {
                "dbid": "DISJ01fc45c5c6",
                "code": "24569638",
                "name": "ДОЧІРНЄ ПІДПРИЄМСТВО \"ЛІКУВАЛЬНО-ОЗДОРОВЧИЙ КОМПЛЕКС \"КОРАБЕЛЬ\" АКЦІОНЕРНОГО ТОВАРИСТВА \"ЗАВОД \"ЛЕНІНСЬКА КУЗНЯ\"",
                "subject_kind": 1,
                "subject_kind_text": "Юридична особа",
                "state_text": "припинення",
                "state_color": "DarkOrange",
                "state_id": "2",
                "address": "08105, Київська обл., Києво-Святошинський район, село Горенка, ВУЛИЦЯ ЛЕНІНА, будинок 125-А",
                "activity": null,
                "director": "Рожковський Франц Антонович керівник",
                "region_code": "32",
                "region_display_name": "Київська",
                "match_kind": "актуальні: назва",
                "relevance_date": "2025-03-14 00:00:00.000"
            }
        ],
        "message": {
            "text": "У вашому тарифі не оплачена можливість повного пошуку.  Вам доступний обмежений пошук в системі - не більше 3 варіантів. Ви можете спробувати всі можливості системи активувавши тестовий тариф",
            "color": "blue"
        }
    }
}