Jak pobrać przez API treść wpisów do KRS wygenerowanych na podstawie odpisów pełnych?

MGBI dostarcza kompleksowe API do pobierania danych z rejestrów i ewidencji publicznych, w tym z Krajowego Rejestru Sądowego (KRS). Listę źródeł danych dostępnych w tej usłudze znajdziesz na stronie:
👉 Rejestry Publiczne API

Ten poradnik dotyczy API dla wpisów do rejestru KRS, który udostępniamy w ramach produktu:
👉 Krajowy Rejestr Sądowy API (KRS API) - Wyszukiwarka Podmiotów

Poniżej opisaliśmy, w jaki sposób możesz pobrać przez API treść wpisów do Krajowego Rejestru Sądowego (KRS) dla wskazanego podmiotu na podstawie jego numeru rejestrowego: KRS, NIP lub REGON.

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:
👉 Krajowy Rejestr Sądowy API (KRS API) - Wyszukiwarka podmiotów

Krok 2: Wywołaj endpoint Get Records

Wpisy do rejestru KRS udostępniamy w MGBI API w modelu danych o identyfikatorze pl-krs-wp-entry.

API udostępnia dla tego modelu endpoint Get Records, który zwraca listę wpisów do KRS wygenerowanych na podstawie treści odpisów pełnych z Wyszukiwarki Podmiotów KRS dla podmiotów spełniających podane kryteria.
👉 Dokumentacja endpointu Get Records dla modelu pl-krs-wp-entry

Pobranie listy wpisów do KRS pojedynczego podmiotu wymaga podania w endpoincie Get Records jego numeru rejestrowego: KRS, NIP lub REGON oraz dodatkowych parametrów, takich jak:

• entry.date_from - wyszukiwanie od daty wprowadzenia wpisu do rejestru
• entry.date_to - wyszukiwanie do daty wprowadzenia wpisu do rejestru

W przykładzie poniżej endpoint Get Records został użyty do odnalezienia wpisów do KRS od roku 2025 dla podmiotu o podanym numerze NIP.

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

GET /v1/models/pl-krs-wp-entry/records?entry.date_from=2025-01-01&identifiers.pl_nip=[numer NIP] HTTP/1.1
Host: api.mgbi.pl
Authorization: [klucz autoryzacji]

Krok 3: Odczytaj z odpowiedzi listę wpisów KRS dla podmiotu

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": 1,
    "pages": 1,
    "results": [
        {
            "id": "[identyfikator rekordu]",
            "identifiers": "[identyfikatory podmiotu]",
            "entry": "[informacje o wpisie]",
            "content": "[treść wpisu]",
            "meta": "[metadane rekordu]"
        }
    ]
}

Każdy rekord z listy zawiera zestaw informacji o pojedynczym wpisie do KRS dla wskazanego podmiotu.

Najważniejsze informacje o wpisie dostępne są w słowniku entry.

Zawartość słownika entry dla pojedynczego wpisu do KRS:

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

Pełna treść wpisu zawarta jest w polach słownika content.

Zawartość słownika content dla pojedynczego wpisu do KRS:

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

Uzyskaj więcej informacji:
👉 Struktura danych w modelu pl-krs-wp-entry
👉 Dokumentacja endpointów dla modelu pl-krs-wp-entry