Jak pobrać przez API aktualną listę członków zarządu 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 wyszukiwarki podmiotów KRS, który udostępniamy w ramach produktu:
👉 Krajowy Rejestr Sądowy API (KRS API) - Wyszukiwarka Podmiotów

Poniżej opisaliśmy, w jaki sposób możesz pobrać przez API aktualną listę członków zarządu dla wskazanego podmiotu na podstawie jego numeru KRS.

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) - Wyszukiwarka Podmiotów

Krok 2: Wywołaj endpoint Get Records

Dane dostępne w wyszukiwarce podmiotów KRS udostępniamy w MGBI API w modelu danych o identyfikatorze pl-krs-wp-record.

API udostępnia dla tego modelu endpoint Get Records, który zwraca rekordy zawierające treść odpisu aktualnego oraz pełnego z KRS dla podmiotów spełniających podane kryteria.
👉 Dokumentacja endpointu Get Records dla modelu pl-krs-wp-record

Pobranie danych pojedynczego podmiotu z KRS 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-wp-record/records?identifiers.pl_krs=[numer KRS] HTTP/1.1
Host: api.mgbi.pl
Authorization: [klucz autoryzacji]

Krok 3: Odczytaj z odpowiedzi dane członków zarządu

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

W powyższym przykładzie endpoint powinien zwrócić listę wyników zawierającą jeden rekord:

{
    "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]
        }
    ]
}

Aktualną listę członków zarządu podmiotu znajdziesz w polu: content.current_excerpt.dane.dzial2.reprezentacja.sklad

Każdy element listy umieszczonej w tym polu zawiera dane pojedynczej osoby pełniącej jakąś funkcję w organie reprezentacji podmiotu.

Przykładowa zawartość elementu listy 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]
}

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