Інформація з ЄДР по коду ЮО/ФОП

Повертає інформацію по ЮО або ФОП в структурованому вигляді.
Якщо onlyCheckIsUpdated = false - повертає дані які є в БД. Якщо true - повертає тільки поля isUpdating та updatedDateTime.
В залежності від значення параметру ensureValidOnDate дані можуть бути поставлені в чергу на оновлення.
допустимі значення ensureValidOnDate:

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

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

“YYYY-MM-DD” - будуть поставлені якщо оновлювалися раніш ніж передана дата

“none” або “-” - не будуть ставитися в чергу на оновлення
Параметр onlyCheckIsUpdated впливає тільки на то буде повернута інформація в полі data чи ні. Якщо onlyCheckIsUpdated = true та ensureValidOnDate = “today” - дані будуть поставлені на оновлення, якщо дата їх оновлення раніша за сьогоднішню.

Request

Authorization

Add parameter in query

key

Example:

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

Query Params

code

string

required

код юр/фіз особи (тільки цифри, 8 або 10 знаків)

ensureValidOnDate

string

optional

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

onlyCheckIsUpdated

boolean

optional

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

wait_data_timeout

integer

optional

час в секундах очікування даних (за вмовчанням:3с. не більше ніж 30с)

language

string

optional

3 літ. ISO 639-1

key

string

optional

ключ доступу

Responses

🟢200Success

application/json

Body

answer

object

required

data

object (PersonStruct)

optional

структура даних

is_updating

boolean

required

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

updated_datetime

string <date-time>

required

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

data_checkvalue

string

required

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

status

enum<string>

required

Allowed values:

SuccessWarningError

statusCode

integer

required

message

string

optional

Examples

SuccessSuccess (only check update)

{
    "status": "Warning",
    "statusCode": 205,
    "message": "Дані не актуальні. Дані оновлюються.",
    "answer": {
        "data": {
            "state": 1,
            "state_text": "діє",
            "code": "14312364",
            "is_individual": false,
            "names": {
                "name": "ПРИВАТНЕ АКЦІОНЕРНЕ ТОВАРИСТВО \"ЗАВОД \"КУЗНЯ НА РИБАЛЬСЬКОМУ\"",
                "include_olf": null,
                "display": "ПРИВАТНЕ АКЦІОНЕРНЕ ТОВАРИСТВО \"ЗАВОД \"КУЗНЯ НА РИБАЛЬСЬКОМУ\"",
                "short": "ПРАТ \"ЗАВОД \"КУЗНЯ НА РИБАЛЬСЬКОМУ\"",
                "name_en": "PRIVATE STOCK COMPANY \"PLANT \"KUZNYA ON RYBALSKY\"",
                "short_en": "PRSC PLANT \"KUZNYA ON RYBALSKY\""
            },
            "olf_code": "230",
            "olf_name": "АКЦІОНЕРНЕ ТОВАРИСТВО",
            "founding_document": null,
            "executive_power": {
                "name": "ФОНД ДЕРЖАВНОГО МАЙНА УКРАЇНИ",
                "code": "00032945"
            },
            "object_name": "Подільська районна в місті Києві державна адміністрація",
            "founders": [
                {
                    "name": "акціонери згідно реєстру",
                    "code": null,
                    "address": null,
                    "last_name": null,
                    "first_middle_name": null,
                    "role": 4,
                    "role_text": "засновник",
                    "id": null,
                    "url": null,
                    "capital": "168087346"
                }
            ],
            "branches": [
                {
                    "name": "ЖИТЛОВО-КОМУНАЛЬНИЙ ВІДДІЛ ПРАТ \"ЗАВОД \"КУЗНЯ НА РИБАЛЬСЬКОМУ\"",
                    "code": "25291335",
                    "role": 5,
                    "role_text": "відокремлений підрозділ",
                    "address": {
                        "zip": "04176",
                        "country": "UKR",
                        "address": "04176, місто Київ, ВУЛИЦЯ ЕЛЕКТРИКІВ, будинок 26",
                        "parts": {
                            "atu": "місто Київ",
                            "atu_code": "8000000000",
                            "street": "вулиця ЕЛЕКТРИКІВ",
                            "house_type": "будинок",
                            "house": "26",
                            "building_type": "",
                            "building": "",
                            "num_type": "",
                            "num": ""
                        }
                    }
                },
                {
                    "name": "ТЕРИТОРІАЛЬНО-ВІДОКРЕМЛЕНИЙ ПІДРОЗДІЛ-ЗДАВАЛЬНА БАЗА ПРАТ \"ЗАВОД \"КУЗНЯ НА РИБАЛЬСЬКОМУ\"",
                    "code": "26347190",
                    "role": 5,
                    "role_text": "відокремлений підрозділ",
                    "address": {
                        "zip": "73000",
                        "country": "UKR",
                        "address": "73000, Херсонська обл., місто Херсон, КАРАНТИННИЙ ОСТРІВ, будинок 1",
                        "parts": {
                            "atu": "Херсонська обл., місто Херсон",
                            "atu_code": "6510100000",
                            "street": "КАРАНТИННИЙ ОСТРІВ",
                            "house_type": "будинок",
                            "house": "1",
                            "building_type": "",
                            "building": "",
                            "num_type": "",
                            "num": ""
                        }
                    }
                }
            ],
            "authorised_capital": {
                "value": 168087346,
                "date": null
            },
            "management": "ЗАГАЛЬНІ ЗБОРИ",
            "managing_paper": null,
            "is_modal_statute": null,
            "activity_kinds": [
                {
                    "code": "30.11",
                    "name": "Будування суден і плавучих конструкцій",
                    "is_primary": true
                },
                {
                    "code": "33.15",
                    "name": "Ремонт і технічне обслуговування суден і човнів ",
                    "is_primary": false
                },
                {
                    "code": "41.20",
                    "name": "Будівництво житлових і нежитлових будівель",
                    "is_primary": false
                },
                {
                    "code": "46.11",
                    "name": "Діяльність посередників у торгівлі сільськогосподарською сировиною, живими тваринами, текстильною сировиною та напівфабрикатами",
                    "is_primary": false
                },
                {
                    "code": "46.14",
                    "name": "Діяльність посередників у торгівлі машинами, промисловим устаткованням, суднами та літаками ",
                    "is_primary": false
                },
                {
                    "code": "46.32",
                    "name": "Оптова торгівля м'ясом і м'ясними продуктами ",
                    "is_primary": false
                },
                {
                    "code": "46.33",
                    "name": "Оптова торгівля молочними продуктами, яйцями, харчовими оліями та жирами",
                    "is_primary": false
                },
                {
                    "code": "55.20",
                    "name": "Діяльність засобів розміщування на період відпустки та іншого тимчасового проживання",
                    "is_primary": false
                },
                {
                    "code": "72.19",
                    "name": "Дослідження й експериментальні розробки у сфері інших природничих і технічних наук",
                    "is_primary": false
                },
                {
                    "code": "82.99",
                    "name": "Надання інших допоміжних комерційних послуг, н.в.і.у.",
                    "is_primary": false
                },
                {
                    "code": "25.11",
                    "name": "Виробництво будівельних металевих конструкцій і частин конструкцій",
                    "is_primary": false
                },
                {
                    "code": "25.30",
                    "name": "Виробництво парових котлів, крім котлів центрального опалення",
                    "is_primary": false
                },
                {
                    "code": "25.40",
                    "name": "Виробництво зброї та боєприпасів",
                    "is_primary": false
                }
            ],
            "heads": [
                {
                    "name": "ШАНДРА ВАЛЕРІЙ ОЛЕКСАНДРОВИЧ",
                    "code": null,
                    "address": null,
                    "last_name": null,
                    "first_middle_name": null,
                    "role": 3,
                    "role_text": "керівник",
                    "id": null,
                    "url": null,
                    "appointment_date": null,
                    "restriction": ""
                },
                {
                    "name": "ШАНДРА ВАЛЕРІЙ ОЛЕКСАНДРОВИЧ",
                    "code": null,
                    "address": null,
                    "last_name": null,
                    "first_middle_name": null,
                    "role": 2,
                    "role_text": "підписант",
                    "id": null,
                    "url": null,
                    "appointment_date": null,
                    "restriction": ""
                }
            ],
            "address": {
                "zip": "04176",
                "country": "UKR",
                "address": "04176, місто Київ, ВУЛИЦЯ ЕЛЕКТРИКІВ, будинок 26",
                "parts": {
                    "atu": "місто Київ",
                    "atu_code": "8000000000",
                    "street": "вулиця ЕЛЕКТРИКІВ",
                    "house_type": "будинок",
                    "house": "26",
                    "building_type": "",
                    "building": "",
                    "num_type": "",
                    "num": ""
                }
            },
            "registration": {
                "date": "1996-12-25",
                "record_number": "10711200000002994",
                "record_date": "2005-07-28",
                "is_separation": null,
                "is_division": null,
                "is_merge": null,
                "is_transformation": null
            },
            "bankruptcy": null,
            "termination": null,
            "termination_cancel": null,
            "assignees": [],
            "predecessors": [],
            "registrations": [
                {
                    "name": "ДЕРЖАВНА СЛУЖБА СТАТИСТИКИ УКРАЇНИ",
                    "code": "37507880",
                    "type": "4000",
                    "description": null,
                    "start_date": "1994-09-22",
                    "start_num": null,
                    "end_date": null,
                    "end_num": null
                },
                {
                    "name": "ГОЛОВНЕ УПРАВЛІННЯ ДПС У М.КИЄВІ, ДПІ У ПОДІЛЬСЬКОМУ РАЙОНІ (ПОДІЛЬСЬКИЙ РАЙОН М.КИЄВА)",
                    "code": "44116011",
                    "type": "4002",
                    "description": null,
                    "start_date": "1997-03-06",
                    "start_num": "42426",
                    "end_date": null,
                    "end_num": null
                },
                {
                    "name": "ГОЛОВНЕ УПРАВЛІННЯ ДПС У М.КИЄВІ, ДПІ У ПОДІЛЬСЬКОМУ РАЙОНІ (ПОДІЛЬСЬКИЙ РАЙОН М.КИЄВА)",
                    "code": "44116011",
                    "type": "4001",
                    "description": null,
                    "start_date": "1999-02-25",
                    "start_num": "05-4521",
                    "end_date": null,
                    "end_num": null
                }
            ],
            "primary_activity_kind": {
                "name": "Будування суден і плавучих конструкцій",
                "code": "30.11",
                "reg_number": "05-4521",
                "class": "66"
            },
            "prev_registration_end_term": null,
            "contacts": {
                "email": null,
                "tel": [
                    "+38(044)-425-21-50"
                ],
                "fax": "+38(044)-462-54-42",
                "web_page": null
            },
            "open_enforcements": []
        },
        "is_updating": true,
        "updated_datetime": "2023-10-18 10:14:34.303",
        "isUpdating": true,
        "updatedDateTime": "2023-10-18 10:14:34.303",
        "data_checkvalue": "71FD7A90B6628C577B3C516A6D310C4D"
    }
}