MGBI bietet eine umfassende API zum Abruf von Daten aus öffentlichen Registern und Verzeichnissen, darunter aus dem Nationalen Gerichtsregister (KRS). Eine Liste der in diesem Dienst verfügbaren Datenquellen findest du auf der Seite:
👉 Öffentliche Register API
Dieser Leitfaden bezieht sich auf die API für das Finanzdokumenten-Repositorium des KRS, die wir im Rahmen des Produkts
zur Verfügung stellen 👉 API des Nationalen Gerichtsregisters (KRS API) – Finanzdokumenten-Repositorium
Im Folgenden beschreiben wir, wie Sie über die API eine Datei mit dem Inhalt eines Finanzdokuments eines bestimmten Unternehmens aus dem KRS anhand dessen KRS-Nummer und anderer Parameter abrufen können.
Schritt 1: Beziehen Sie einen Autorisierungsschlüssel über die API
Um den Autorisierungsschlüssel zu erhalten, der für den Aufruf der in der MGBI-API verfügbaren Endpunkte erforderlich ist, kontaktieren Sie uns bitte über das Kontaktformular auf der Produktseite:
👉 API des Nationalen Gerichtsregisters (KRS-API) – Repository für Finanzdokumente
Schritt 2: Rufe den Endpunkt „Get Records“ auf
Die im Finanzdokumentenarchiv des KRS verfügbaren Daten stellen wir in der MGBI-API im Datenmodell mit der Kennung „pl-krs-rdf-record“ bereit.
Die API stellt für dieses Modell den Endpunkt „Get Records“ bereit, der Datensätze zurückgibt, die Informationen zu einzelnen Finanzdokumenten enthalten, die den angegebenen Kriterien entsprechen.
👉 Dokumentation zum Endpunkt „Get Records“ für das Modell „pl-krs-rdf-record“
Um eine Liste der im Finanzdokumentenarchiv des KRS für ein ausgewähltes Unternehmen verfügbaren Dokumente abzurufen, muss am Endpunkt „Get Records“ dessen Registrierungsnummer angegeben werden: KRS, NIP oder REGON.
Beispiel für den Aufruf des Endpunkts „Get Records“ mit einer KRS-Nummer:
GET /v1/models/pl-krs-rdf-record/records?identifiers.pl_krs=[KRS-Nummer] HTTP/1.1
Host: api.mgbi.pl
Authorization: [Autorisierungsschlüssel]
Um die Liste auf die Dokumente einzugrenzen, die dich interessieren, kannst du auch zusätzliche Filterparameter verwenden, wie zum Beispiel:
- Typ – Art des Dokuments (z. B. Jahresabschluss, Lagebericht),
- period_major_year – das Jahr, in dem der größte Teil des Zeitraums liegt, auf den sich das Dokument bezieht.
Im folgenden Beispiel wurde der Endpunkt „Get Records“ verwendet, um den Jahresabschluss für das Jahr 2025 für ein Unternehmen mit der angegebenen KRS-Nummer abzurufen.
Beispiel für den Aufruf des Endpunkts „Get Records“ mit KRS-Nummer, Dokumenttyp und Geschäftsjahr:
GET /v1/models/pl-krs-rdf-record/records?identifiers.pl_krs=[KRS-Nummer]&type=financial_statement._major_year=2025 HTTP/1.1
Host: api.mgbi.pl
Authorization: [Autorisierungsschlüssel]
Schritt 3: Entnehmen Sie der Antwort die Adresse, unter der Sie die Dokumentdatei herunterladen können
Ein korrekter Aufruf des Endpunkts „Get Records“ gibt als Antwort eine Liste der Dokumente zurück, die den angegebenen Kriterien entsprechen.
In den vorangegangenen Beispielen sollte der Endpunkt eine Ergebnisliste mit einem oder mehreren Datensätzen zurückgeben:
{
"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]
}
]
}
Die Adresse der Datei mit dem Dokumentinhalt im Originalformat, in dem das Dokument im Dokumentenarchiv des KRS hinterlegt wurde, findest du im Feld „files.main_document.original.url“.
Schritt 4: Lade den Inhalt der Datei herunter und speichere ihn oder sende ihn an den Browser
Um den Inhalt der Datei mit der aktuellen Version abzurufen, sende eine HTTP-GET-Anfrage mit der Adresse, die du aus dem Feld ` files.main_document.original.url ` gelesen hast, und dem Autorisierungsschlüssel der API:
GET [Dateipfad] HTTP/1.1
Host: api.mgbi.pl
Authorization: [Autorisierungsschlüssel]
Du kannst den Inhalt der Datei auch direkt an den Webbrowser des Nutzers deiner Anwendung senden. In diesem Fall musst du den Wert des HTTP-Headers „Content-Type“ festlegen, der den Browser über das Format der übertragenen Datei informiert, basierend auf dem Inhalt des Feldes `files.main_document.original.content_type`.
Weitere Informationen:
👉 Datenstruktur im Modell „pl-krs-rdf-record“
👉 Dokumentation der Endpunkte für das Modell „pl-krs-rdf-record“
