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 plik z treścią dokumentu 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 listy dokumentów dostępnych w Repozytorium Dokumentów Finansowych KRS dla wybranego podmiotu wymaga podania w endpoincie Get Records jego numeru rejestrowego: KRS, NIP lub REGON.
Przykład wywołania endpointu Get Records z numerem KRS:
GET /v1/models/pl-krs-rdf-record/records?identifiers.pl_krs=[numer KRS] HTTP/1.1
Host: api.mgbi.pl
Authorization: [klucz autoryzacji]
Aby ograniczyć listę do interesujących Cię dokumentów, możesz też użyć 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 adres do pobrania pliku dokumentu
Prawidłowe wywołanie endpointu Get Records zwraca w odpowiedzi listę dokumentów spełniających podane kryteria.
We wcześniejszych przykładach 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],
"identifiers": [identyfikatory podmiotu],
"document": [informacje o dokumencie]
"content": [zawartość dokumentu],
"files": [pliki z treścią dokumentu],
"meta": [metadane rekordu]
}
]
}
Adres pliku z treścią dokumentu w oryginalnym formacie, w jakim dokument złożono w Repozytorium Dokumentów Finansowych KRS znajdziesz w polu files.main_document.original.url.
Krok 4: Pobierz treść pliku i zapisz lub wyślij do przeglądarki
Aby pobrać treść pliku z odpisem aktualnym, wywołaj żądanie HTTP GET z adresem odczytanym z pola files.main_document.original.url i kluczem autoryzacji w API:
GET [adres pliku] HTTP/1.1
Host: api.mgbi.pl
Authorization: [klucz autoryzacji]
Możesz też od razu wysłać treść pliku do przeglądarki internetowej użytkownika Twojej aplikacji. W tym przypadku ustaw wartość nagłówka HTTP Content-Type informującego przeglądarkę o formacie przesyłanego pliku na podstawie zawartości pola files.main_document.original.content_type.
Uzyskaj więcej informacji:
👉 Struktura danych w modelu pl-krs-rdf-record
👉 Dokumentacja endpointów dla modelu pl-krs-rdf-record
