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 aufdie API für Einträge im KRS-Register, die wir im Rahmen des folgenden Produkts zur Verfügung stellen:
👉API des Nationalen Gerichtsregisters (KRS API) – Suchmaschine für Rechtsträger
Im Folgenden beschreiben wir, wie Sieüber die API die Einträge im Nationalen Gerichtsregister (KRS) für ein bestimmtes Unternehmen anhand dessen Registrierungsnummer – KRS, NIP oder REGON –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) – Suchmaschine für Rechtsträger
Schritt 2: Rufe den Endpunkt „Get Records“ auf
Die Einträge im KRS-Register stellen wir in der MGBI-API im Datenmodell mit der Kennung„pl-krs-wp-entry“ zur Verfügung.
Die API stellt für dieses Modell den Endpunkt„Get Records“ bereit, der eine Liste der Einträge im KRS zurückgibt, die auf der Grundlage des Inhalts der vollständigen Auszüge aus der KRS-Unternehmenssuche für Unternehmen generiert wurden, die die angegebenen Kriterien erfüllen.
👉Dokumentation zum Endpunkt „Get Records“ für das Modell „pl-krs-wp-entry“
Um eine Liste der Einträge eines einzelnen Unternehmens im KRS abzurufen, muss im Endpunkt „Get Records“ dessen Registrierungsnummer (KRS, NIP oder REGON) sowie zusätzliche Parameter angegeben werden, wie zum Beispiel:
- entry.date_from – Suche ab dem Datum der Eintragung in das Register
- entry.date_to – Suche nach dem Datum der Eintragung in das Register
Im folgenden Beispiel wurde der Endpunkt„Get Records“verwendet, um Einträge im KRS ab dem Jahr 2025 für ein Unternehmen mit der angegebenen Steuernummer abzurufen.
Beispiel für den Aufruf des Endpunkts „Get Records“ mit der Steuernummer:
GET /v1/models/pl-krs-wp-entry/records?entry.date_from=2025-01-01&identifiers.pl_nip=[Steuernummer] HTTP/1.1
Host: api.mgbi.pl
Authorization: [Autorisierungsschlüssel]Schritt 3: Lesen Sie aus der Antwort die Liste der KRS-Einträge für das Unternehmen ab
Ein korrekter Aufruf des Endpunkts„Get Records“gibt als Antwort eine Liste der Datensätze zurück, die den angegebenen Kriterien entsprechen. Im obigen Beispiel sollte der Endpunkt eine Ergebnisliste mit einem oder mehreren Datensätzen zurückgeben:
{
"count": 1,
"pages": 1,
"results": [
{
"id": "[identyfikator rekordu]",
"identifiers": "[identyfikatory podmiotu]",
"entry": "[informacje o wpisie]",
"content": "[treść wpisu]",
"meta": "[metadane rekordu]"
}
]
}Jeder Datensatz in der Liste enthält eine Reihe von Informationen zu einem einzelnen Eintrag im KRS für das angegebene Unternehmen.
Die wichtigsten Informationen zum Eintrag finden Sie imEintragsverzeichnis.
Inhalt des Eintrags für einen einzelnen Eintrag im KRS:
{
"signature": "[sygnatura wpisu]",
"date": "[data wprowadzenia wpisu do rejestru w formacie ISO 8601]",
"number": "[numer wpisu]"
}Der vollständige Text des Eintrags ist in den Felderndes Content-Wörterbuchs enthalten.
Inhalt des Datenfelds „content“ für einen einzelnen Eintrag im KRS:
{
"xml": "[treść wpisu w formacie XML]",
"html": "[treść wpisu w formacie HTML]"
}Weitere Informationen:
👉Datenstruktur des Modells „pl-krs-wp-entry“
👉Dokumentation der Endpunkte für das Modell „pl-krs-wp-entry“
