Пошук зв’язків між двома ЮО/ФОП/засновниками/уповноваженими персонами

Шукати зв’язки між особою визначеною кодом ЄДРПОУ/ІПН або ПІБ особи (в форматі «Прізвище Ім’я» або ‘Прізвище Ім’я По-батькові’) (text1 - код або .ПІБ, text1_iscode - ознака, що саме вказано) та другою особою визначеною таким же чином (text2 - код або .ПІБ, text2_iscode - ознака, що саме вказано).
maxdepth (максимальна кількість зв’язків у ланцюгу) – для обмеження складності пошуку при непрямих зв’язках. Наприклад «ланцюг з 1 зв’язком» – пряме співпадіння (в суб’єктів 1 и 2 є щось спільне – наприклад уповноважена особа або адреса), «ланцюг з 2 зв’язками» – особа 1 має щось спільне з особою 3, яка у свою чергу, має щось спільне з особою 2. Якщо передано maxdepth <= 0 – використовується значення за умовчанням. Зараз це 4 (воно ж максимально допус
only_reliable – використовувати тільки зв’язки з високою достовірністю.
only_actual - видавати тільки актуальні зв’язки
Повертає масив "ланцюгів зв'язку". Якщо зв'язків не знайдено - масив порожній
Кожен "ланцюг зв'язку" - це масив структур,

У першому елементі масиву - relation_kinds завжди порожній, у подальших елементах - описує зв'язок (або декілька) що зв'язує безпосередньо персону з попереднього елементу та персону з цього елементу.
match_id - 1-Через фізичну персону, 2-Через юридичну особу, 3-Через адресу, 4-Через контакт, 5-Правонаступники, 6-Філії,7-ФПГ, Холдинги ...

Request

Authorization

Add parameter in query

key

Example:

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

Query Params

text1

string

required

код або ПІБ особи

text1_iscode

boolean

required

ознака що міститься в text1. Якщо true, то в texт1 код, інакше ПІБ

text2

string

required

код або ПІБ особи

text2_iscode

boolean

required

ознака що міститься в text2. Якщо true, то в texт2 код, інакше ПІБ

maxdepth

integer

optional

максимальна довжина ланцюгу зв’язків

>= 0<= 5

only_actual

boolean

optional

повертати лише актуальні зв'язки

only_reliable

boolean

optional

повертати лише зв'язки з високою достовірністю

language

string

optional

3 літ. ISO 639-1

key

array[string]

optional

ключ доступу

Example:

[]

Responses

🟢200Success

application/json

Body

answer

object

required

data

array [array]

required

status

enum<string>

required

Allowed values:

SuccessWarningError

statusCode

integer

required

message

string

optional

Example

{
    "status": "Success",
    "statusCode": 301,
    "message": "",
    "answer": {
        "data": [
            [
                {
                    "relation_kinds": [],
                    "person_info": {
                        "code": "14312364",
                        "full_name": "ПРИВАТНЕ АКЦІОНЕРНЕ ТОВАРИСТВО \"ЗАВОД \"КУЗНЯ НА РИБАЛЬСЬКОМУ\"",
                        "short_name": "ПРАТ \"ЗАВОД \"КУЗНЯ НА РИБАЛЬСЬКОМУ\"",
                        "is_individual": false,
                        "state_text": "діє",
                        "state_id": "1",
                        "address": "04176, місто Київ, ВУЛИЦЯ ЕЛЕКТРИКІВ, будинок 26",
                        "activity": "30.11 Будування суден і плавучих конструкцій",
                        "director": "Шандра Валерій Олександрович керівник",
                        "region_code": "80",
                        "region_display_name": "Київ"
                    }
                },
                {
                    "relation_kinds": [
                        {
                            "match_id": "2",
                            "match_name": "Через юридичну особу",
                            "description": "Засновані юридичні особи",
                            "is_actual": true,
                            "veracity": 99
                        }
                    ],
                    "person_info": {
                        "code": "25636012",
                        "full_name": "АСОЦІАЦІЯ СУДНОБУДІВНИКІВ УКРАЇНИ \"УКРСУДПРОМ\"",
                        "short_name": "\"УКРСУДПРОМ\"",
                        "is_individual": false,
                        "state_text": "діє",
                        "state_id": "1",
                        "address": "01032, місто Київ, ВУЛИЦЯ ЖИЛЯНСЬКА, будинок 107, корпус 26",
                        "activity": "70.22 Консультування з питань комерційної діяльності й керування",
                        "director": "Лисицький Віктор Іванович керівник 06.12.2013",
                        "region_code": "80",
                        "region_display_name": "Київ"
                    }
                }
            ]
        ]
    }
}