How can I use the API to retrieve the content of announcements and entries in the National Court Register (KRS) published in MSIG for a specific entity?

MGBI provides a comprehensive API for retrieving data from public registers and records, including the Court and Economic Monitor (MSIG).

You can find a list of data sources available through this service at:
👉 Public Registers API

This guide covers the API for the Court and Business Monitor, which we provide as part of the following product:
👉 Court and Business Monitor API (MSIG API)

Below, we describe how you can use the API to retrieve the content of announcements and entries in the National Court Register (KRS) published in MSIG for a specific entity based on its KRS number.

Step 1: Obtain an API authorization key

To obtain the authorization key required to call endpoints available in the MGBI API, please contact us using the contact form on the product page:
👉 Monitor Sądowy i Gospodarczy API (MSIG API)

Step 2: Call the Get Records endpoint

We make the data available in the Court and Economic Monitor accessible via the MGBI API in the data model with the identifier pl-msig-record.

The API provides a Get Records endpoint for this model, which returns records containing the content of the current and full extracts from the National Court Register (KRS) for entities that meet the specified criteria.
👉 Documentation for the Get Records endpoint for the pl-msig-record model

To retrieve a list of announcements and entries in the National Court Register (KRS) for a specific entity, you must provide its KRS number in the Get Records endpoint.

Example of calling the Get Records endpoint with a KRS number:

GET /v1/models/pl-msig-record/records?identifiers.pl_krs=[KRS number] HTTP/1.1
Host: api.mgbi.pl
Authorization: [authorization key]

Step 3: Review the list of announcements and entries in the National Court Register (KRS) provided in the response

A successful call to the Get Records endpoint returns a list of records that meet the specified criteria.

In the example above, the endpoint should return a list of results containing one or more records:

{
    "count": [liczba wyników],
    "pages": [liczba stron wyników],
    "results": [
        {
            "id": [identyfikator rekordu],
            "entities": [dane podmiotów, których dotyczy ogłoszenie],
            "msig": [parametry ogłoszenia w MSIG],
            "content": [treść ogłoszenia],
            "meta": [metadane rekordu]
        }
    ]
}

Each record in the list contains a set of data for a single advertisement or entry in the National Court Register.

Information about the MSIG number associated with the announcement is available in the msig dictionary.

Contents of the msig dictionary for a single listing:

{
    "chapter": [rozdział MSIG],
    "section": [sekcja MSIG],
    "subsection": [podsekcja MSIG],
    "page_number": [numer strony MSIG z ogłoszeniem],
    "position_number": [numer pozycji ogłoszenia],
    "signature": [sygnatura ogłoszenia],
    "year": [rok wydania MSIG],
    "yearly_number": [numer roczny MSIG],
    "sequential_number": [numer kolejny MSIG]
}

The ad content in XML format is contained in the fields of the " content" dictionary.

Dictionary content for a single listing:

{
    "header_xml": [nagłówek ogłoszenia],
    "body_xml": [treść ogłoszenia],
    "krs_entry_xml": [treść wpisu do KRS]
}

Learn more:
👉 Data structure in the pl-msig-record model
👉 Endpoint documentation for the pl-msig-record model