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 die Suchmaschine für Unternehmen im KRS, die wir im Rahmen des Produkts
zur Verfügung stellen 👉 API des Nationalen Gerichtsregisters (KRS API) – Suchmaschine für Unternehmen
Im Folgenden beschreiben wir, wie Sie über die API die aktuelle Liste der Vorstandsmitglieder für ein bestimmtes Unternehmen anhand dessen KRS-Nummer 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 in der KRS-Unternehmenssuche verfügbaren Daten stellen wir in der MGBI-API im Datenmodell mit der Kennung „pl-krs-wp-record“ bereit.
Die API stellt für dieses Modell den Endpunkt „Get Records“ zur Verfügung, der Datensätze mit dem Inhalt des aktuellen und vollständigen Auszugs aus dem KRS für Unternehmen zurückgibt, die die angegebenen Kriterien erfüllen.
👉 Dokumentation zum Endpunkt „Get Records“ für das Modell „pl-krs-wp-record“
Um Daten zu einem einzelnen Unternehmen aus dem KRS abzurufen, muss im 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-wp-record/records?identifiers.pl_krs=[KRS-Nummer] HTTP/1.1
Host: api.mgbi.pl
Authorization: [Autorisierungsschlüssel]
Schritt 3: Entnehmen Sie den Antworten die Daten der Vorstandsmitglieder
Bei korrekter Aufrufung des Endpunkts „Get Records“ wird als Antwort eine Liste der Datensätze zurückgegeben, die den angegebenen Kriterien entsprechen.
Im obigen Beispiel sollte der Endpunkt eine Ergebnisliste mit einem Datensatz zurückgeben:
{
"count": 1,
"pages": 1,
"results": [
{
"id": [identyfikator rekordu],
"identifiers": [identyfikatory podmiotu i powiązanych osób],
"content": [treść odpisu aktualnego i pełnego],
"files": [pliki odpisów w formacie PDF],
"relations": [relacje podmiotu z innymi podmiotami i osobami],
"meta": [metadane rekordu]
}
]
}
Die aktuelle Liste der Vorstandsmitglieder findest du im Feld: content.current_excerpt.dane.dzial2.reprezentacja.sklad
Jeder Eintrag in der Liste in diesem Feld enthält die Daten einer einzelnen Person, die eine bestimmte Funktion in einem Vertretungsorgan des Unternehmens ausübt.
Beispiel für den Inhalt des Listenelements „content.current_excerpt.dane.dzial2.reprezentacja.sklad“:
{
"nazwisko": {
"nazwiskoICzlon": [pierwszy człon nazwiska],
"nazwiskoIICzlon": [drugi człon nazwiska]
},
"imiona": {
"imie": [imię]
},
"identyfikator": {
"pesel": [numer PESEL]
},
"funkcjaWOrganie": [nazwa pełnionej funkcji],
"czyZawieszona": [czy osoba została zawieszona w czynnościach]
}
Weitere Informationen:
👉 Datenstruktur im Modell „pl-krs-wp-record“
👉 Dokumentation der Endpunkte für das Modell „pl-krs-wp-record“
