Jak pobrać przez API wybrane pola sprawozdania finansowego podmiotu z KRS?

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 Repozytorium Dokumentów Finansowych KRS, który udostępniamy w ramach produktu:
👉 Krajowy Rejestr Sądowy API (KRS API) - Repozytorium Dokumentów Finansowych

Poniżej opisaliśmy, w jaki sposób możesz pobrać przez API wybrane pola sprawozdania finansowego wskazanego podmiotu z KRS na podstawie jego numeru KRS i innych parametrów.

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) - Repozytorium Dokumentów Finansowych

Krok 2: Wywołaj endpoint Get Records

Dane dostępne w Repozytorium Dokumentów Finansowych KRS udostępniamy w MGBI API w modelu danych o identyfikatorze pl-krs-rdf-record.

API udostępnia dla tego modelu endpoint Get Records, który zwraca rekordy zawierające informacje o poszczególnych dokumentach finansowych spełniających podane kryteria.
👉 Dokumentacja endpointu Get Records dla modelu pl-krs-rdf-record

Pobranie rekordu z treścią sprawozdania finansowego z Repozytorium Dokumentów Finansowych KRS dla wybranego podmiotu wymaga podania w endpoincie Get Records jego numeru rejestrowego: KRS, NIP lub REGON, oraz dodatkowych parametrów, takich jak:

• type - rodzaj dokumentu (np. roczne sprawozdanie finansowe, sprawozdanie zarządu z działalności podmiotu),
• period_major_year - rok przeważającej części okresu, którego dotyczy dokument.

W przykładzie poniżej endpoint Get Records został użyty do odnalezienia sprawozdania finansowego za 2025 rok dla podmiotu o podanym numerze KRS.

Przykład wywołania endpointu Get Records z numerem KRS, rodzajem dokumentu i rokiem obrachunkowym:

GET /v1/models/pl-krs-rdf-record/records?identifiers.pl_krs=[numer KRS]&type=financial_statement._major_year=2025 HTTP/1.1
Host: api.mgbi.pl
Authorization: [klucz autoryzacji]

Krok 3: Odczytaj z odpowiedzi wybrane pola sprawozdania

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

We wcześniejszym przykładzie endpoint powinien zwrócić listę wyników zawierającą jeden rekord:

{
    "count": 1,
    "pages": 1,
    "results": [
        {
            "id": [identyfikator rekordu],
            "identifiers": [identyfikatory podmiotu],
            "document": [informacje o dokumencie]
            "content": [zawartość dokumentu],
            "files": [pliki z treścią dokumentu],
            "meta": [metadane rekordu]
        }
    ]
}

Pola dostępne w sprawozdaniach finansowych w formacie XML zgodnym ze strukturami logicznymi polskiego Ministerstwa Finansów przechowywane są w dwóch słownikach:

• content.extracted_fields,
• content.standardized_fields.

Słownik content.extracted_fields zawiera wszystkie pola dostępne w sprawozdaniu zgodnie z użytą strukturą logiczną.

Pełną listę pól dostępnych w tym słowniku udostępniamy w pliku Excel. Skontaktuj się z nami przy użyciu formularza na stronie produktu, aby otrzymać link do pobrania pliku.

Przykładowa zawartość słownika content.extracted_fields:

{
    "bs": {
        "a_ca_cfy": 0,
        "a_ca_pfy": 0,
        "a_fa_cfy": 0,
        "a_fa_pfy": 0,
        "a_ta_cfy": 0,
        "a_ta_pfy": 0,
        ...
    }
}

Jeśli potrzebujesz dostępu do wszystkich pól finansowych w sprawozdaniu, użyj słownika content.extracted_fields. Jeżeli natomiast wystarczą Ci najważniejsze pola z bilansu lub rachunku zysków i strat, wykorzystaj słownik content.standardized_fields.

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