Як за допомогою API завантажити зміст записів до КРС, сформованих на основі повних виписок?

MGBI надає комплексний API для отримання даних із державних реєстрів та облікових баз, зокрема з Національного судового реєстру (KRS). Перелік джерел даних, доступних у цій службі, можна знайти на сайті:
👉Державні реєстри API

Цей посібник стосуєтьсяAPI для записів у реєстрі KRS, який ми надаємо в рамках продукту:
👉API Національного судового реєстру (KRS API) — Пошукова система суб’єктів господарювання

Нижче ми описали, якза допомогою API можназавантажити дані записів у Національному судовому реєстрі (KRS) щодо вказаного суб’єкта на підставі його реєстраційного номера: KRS, NIP або REGON.

Крок 1: Отримати ключ авторизації в API

Щоб отримати ключ авторизації, необхідний для виклику кінцевих точок, доступних в MGBI API, зв’яжіться з нами за допомогою контактної форми на сторінці продукту:
👉API Національного судового реєстру (KRS API) — Пошукова система суб’єктів господарювання

Крок 2: Викличте кінцеву точку Get Records

Записи в реєстрі KRS доступні в MGBI API у моделі даних з ідентифікаторомpl-krs-wp-entry.

API надає для цієї моделі кінцеву точкуGet Records, яка повертає список записів у KRS, сформованих на основі повних виписок із Пошукової системи суб’єктів KRS для суб’єктів, що відповідають вказаним критеріям.
👉Документація кінцевої точки Get Records для моделі pl-krs-wp-entry

Для отримання списку записів у КРС щодо окремого суб’єкта господарювання необхідно вказати в кінцевій точці Get Records його реєстраційний номер: KRS, NIP або REGON, а також додаткові параметри, такі як:

• entry.date_from — пошук за датою внесення запису до реєстру
• entry.date_to — пошук за датою внесення запису до реєстру

У наведеному нижче прикладі для пошуку записів у КРС за період з 2025 року щодо суб’єкта господарювання із вказаним номером NIP було використано ендпойнтGet Records.

Приклад виклику ендпойнту Get Records із номером NIP:

GET /v1/models/pl-krs-wp-entry/records?entry.date_from=2025-01-01&identifiers.pl_nip=[номер NIP] HTTP/1.1
Host: api.mgbi.pl
Authorization: [ключ авторизації]

Крок 3: З відповіді вичитайте перелік записів у реєстрі KRS щодо суб’єкта господарювання

Правильний виклик кінцевої точкиGet Recordsповертає у відповіді список записів, що відповідають заданим критеріям. У наведеному вище прикладі кінцева точка повинна повернути список результатів, що містить один або кілька записів:

{
    "count": 1,
    "pages": 1,
    "results": [
        {
            "id": "[identyfikator rekordu]",
            "identifiers": "[identyfikatory podmiotu]",
            "entry": "[informacje o wpisie]",
            "content": "[treść wpisu]",
            "meta": "[metadane rekordu]"
        }
    ]
}

Кожен запис у списку містить набір відомостей про окремий запис у КРС щодо зазначеного суб’єкта.

Найважливіша інформація про запис міститься у словникуentry.

Зміст словникового запису для окремого запису в КРС:

{
    "signature": "[sygnatura wpisu]",
    "date": "[data wprowadzenia wpisu do rejestru w formacie ISO 8601]",
    "number": "[numer wpisu]"
}

Повний текст запису міститься в полях словникаcontent.

Зміст розділу «content» для окремого запису в КРС:

{
    "xml": "[treść wpisu w formacie XML]",
    "html": "[treść wpisu w formacie HTML]"
}

Дізнайтеся більше:
👉Структура даних у моделі pl-krs-wp-entry
👉Документація щодо кінцевих точок для моделі pl-krs-wp-entry