Jak pobrać przez API treść ogłoszeń i wpisów do KRS opublikowanych w MSIG dla wskazanego podmiotu?

MGBI dostarcza kompleksowe API do pobierania danych z rejestrów i ewidencji publicznych, w tym z Monitora Sądowego i Gospodarczego (MSIG).

Listę źródeł danych dostępnych w tej usłudze znajdziesz na stronie:
👉 Rejestry Publiczne API

Ten poradnik dotyczy API dla Monitora Sądowego i Gospodarczego, który udostępniamy w ramach produktu:
👉 Monitor Sądowy i Gospodarczy API (MSIG API)

Poniżej opisaliśmy, w jaki sposób możesz pobrać przez API treść ogłoszeń i wpisów do KRS opublikowanych w MSIG dla wskazanego podmiotu na podstawie jego numeru KRS.

Krok 1: Uzyskaj klucz autoryzacji w API

Aby zdobyć klucz autoryzacji wymagany przy wywoływaniu endpointów dostępnych w MGBI API, skontaktuj się z nami przy użyciu formularza kontaktowego na stronie produktu:
👉 Monitor Sądowy i Gospodarczy API (MSIG API)

Krok 2: Wywołaj endpoint Get Records

Dane dostępne w Monitorze Sądowym i Gospodarczym udostępniamy w MGBI API w modelu danych o identyfikatorze pl-msig-record.

API udostępnia dla tego modelu endpoint Get Records, który zwraca rekordy zawierające treść odpisu aktualnego oraz pełnego z KRS dla podmiotów spełniających podane kryteria.
👉 Dokumentacja endpointu Get Records dla modelu pl-msig-record

Pobranie listy ogłoszeń i wpisów do KRS pojedynczego podmiotu wymaga podania w endpoincie Get Records jego numeru KRS.

Przykład wywołania endpointu Get Records z numerem KRS:

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

Krok 3: Odczytaj z odpowiedzi listę ogłoszeń i wpisów do KRS

Prawidłowe wywołanie endpointu Get Records zwraca w odpowiedzi listę rekordów spełniających podane kryteria.

W powyższym przykładzie endpoint powinien zwrócić listę wyników zawierającą jeden lub więcej rekordów:

{
    "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]
        }
    ]
}

Każdy rekord z listy zawiera zestaw danych dla pojedynczego ogłoszenia lub wpisu do KRS.

Dane o numerze MSIG, z którego pochodzi ogłoszenie, dostępne są w słowniku msig.

Zawartość słownika msig dla pojedynczego ogłoszenia:

{
    "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]
}

Treść ogłoszenia w formacie XML zawarta jest w polach słownika content.

Zawartość słownika content dla pojedynczego ogłoszenia:

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

Uzyskaj więcej informacji:
👉 Struktura danych w modelu pl-msig-record
👉 Dokumentacja endpointów dla modelu pl-msig-record