Отримати перелік з реєстру боржників та виконавчих проваджень по персоні

Повертає перелік проваджень з реєстрів, в яких задіяно персону. Персона ідентифікується параметром code або параметром ind_indent.

Якщо заповнено поле ind_ident - поле code може бути порожнім, або в ньому повинен бути код ІПН особи. В полі ind_ident масив name повинен бути не порожнім. Максимальний розмір масиву - 5 елементів - це варіанти написання ПІБ фізичної особи інформацію по якій шукаємо.
Поле birthdate заповнюється якщо відоме - можна заповнити до 5 варіантів дати народження фізичної особи.

В залежності від значення параметру ensure_valid_on_date дані можуть бути поставлені в чергу на оновлення.
Допустимі значення ensureValidOnDate:

“” або “today” - будуть поставлені на оновлення, якщо оновлені не сьогодні

“now” - будуть поставлені на оновлення обов’язково. Запит з цим параметром тарифікується завжди, якщо код не оновлюється саме зараз - тому рекомендується передавати ТІЛЬКИ якщо ви вважаєте, що дані в реєстрі були змінені саме сьогодні, і вас не влаштовують дані що були оновлені раніше в цей же день. Використання цього значення може призвести до необмеженної витрати коштів. Наприклад, якщо кожну хвилину по одному коду робити запит з цим параметром - за добу це буде як 1440 запитів.

Якщо only_check_updated = true - не повертає дані в data.

Request

Authorization

Add parameter in query

key

Example:

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

Body Params application/json

code

string

required

ІПН / ЄДРПОУ (8/10 знаків) або dbid

ind_ident

object

optional

пошук по ПІБ фіз. особи

names

array [object {3}]

optional

масив з ПІБ фіз.особі (допускається до 5-ти варіантів)

birthdate

array[string <date>]

optional

день народження фіз. особи (допускається до 5-ти варіантів)

involved_kind

string

optional

фільтр по типу боржник / кредитор (може бути "debtor" / "creditor" / null)

only_open

boolean

optional

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

date_begin

optional

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

Any of

date

null

date_end

optional

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

Any of

date

null

ensure_valid_on_date

string

optional

чи ставити дані на оновлення (за вмовчанням - today)

only_check_updated

boolean

optional

тільки перевірити стан оновлення даних (за вмовчанням - false)

skip_records

integer

optional

кількість записів, які необхідно пропустити

limit_records

integer

optional

обмежити кількість записів (за умовчанням 50)

>= 0<= 100

language

string

optional

3 літ. ISO 639-1

key

string

optional

ключ доступу

Example

{
    "code": "",
    "ind_ident": {
        "names": [
            {
                "family": "Ковальчук",
                "name": "Олексій",
                "middlename": "Леонідович"
            }
        ],
        "birthdate": [
            "1982-02-03"
        ]
    },
    "involved_kind": "creditor",
    "only_open": false,
    "date_begin": "2020-01-01",
    "date_end": "2020-05-01",
    "ensure_valid_on_date": "",
    "only_check_updated": false,
    "skip_records": 0,
    "limit_records": 50,
    "language": "ukr"
}

Responses

🟢200Success

application/json

Body

status

enum<string>

required

Allowed values:

SuccessWarningError

statusCode

integer

required

message

string

optional

answer

object

required

data

array [object {12}]

required

message

object

required

data_checkvalue

string

required

якщо значення змінюється - дані були змінені

is_updating

boolean

required

чи зараз в процесі оновлення

updated_datetime

required

час останнього оновлення

update_failed

boolean

required

ознака того, що оновлення не відбулося

Example

{
    "status": "Success",
    "statusCode": 301,
    "message": "",
    "answer": {
        "data": [
            {
                "number": "61547937",
                "date_open": "2020-03-25",
                "state": "Завершено",
                "state_color": "black",
                "description": null,
                "publisher": null,
                "involved_kind": "creditor",
                "unequivocally": true,
                "executor": {
                    "organization": "Дніпровський ВДВС у м. Києві ЦМУ МЮ (м. Київ)",
                    "person": null,
                    "email": null
                },
                "debtors": [
                    {
                        "name": "КОМУНАЛЬНЕ ПІДПРИЄМСТВО ВИКОНАВЧОГО ОРГАНУ КИЇВРАДИ \"КИЇВТЕПЛОЕНЕРГО\"",
                        "code": "40538421",
                        "birthdate": null,
                        "kind": "Комунальне підприємство"
                    }
                ],
                "creditors": [
                    {
                        "name": "Ковальчук Олексій Леонідович",
                        "code": "",
                        "birthdate": "1982-02-03",
                        "kind": "Фізична особа"
                    }
                ],
                "veracity": 99
            },
            {
                "number": "61547573",
                "date_open": "2020-03-25",
                "state": "Завершено",
                "state_color": "black",
                "description": null,
                "publisher": null,
                "involved_kind": "creditor",
                "unequivocally": true,
                "executor": {
                    "organization": "Дніпровський ВДВС у м. Києві ЦМУ МЮ (м. Київ)",
                    "person": null,
                    "email": null
                },
                "debtors": [
                    {
                        "name": "Комунальне підприємство виконавчого органу Київради \"Київтеплоенерго\"",
                        "code": "40538421",
                        "birthdate": null,
                        "kind": "Комунальне підприємство"
                    }
                ],
                "creditors": [
                    {
                        "name": "Ковальчук Олексій Леонідович",
                        "code": "",
                        "birthdate": "1982-02-03",
                        "kind": "Фізична особа"
                    }
                ],
                "veracity": 99
            }
        ],
        "message": {
            "text": "",
            "color": "black"
        },
        "data_checkvalue": "",
        "is_updating": false,
        "updated_datetime": null,
        "update_failed": false
    }
}