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ę powiązań wskazanego podmiotu z KRS z innymi podmiotami i osobami 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:
{
"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]
}
]
}
Krok 3: Odczytaj z odpowiedzi dane o powiązaniach
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ę powiązań podmiotu z innymi podmiotami i osobami znajdziesz w polu relations.
Każdy element słownika umieszczonego w tym polu zawiera listę powiązań określonego typu wraz z danymi powiązanych podmiotów i osób oraz dodatkowych informacjami.
Przykładowa zawartość słownika relations:
{
"dzial2_reprezentacja_sklad": [lista powiązań z członkami organów reprezentacji],
"dzial2_prokurenci": [lista powiązań z prokurentami],
"dzial2_organNadzoru_sklad": [lista powiązań z członkami organów nadzoru]
}
Struktura danych w elementach list jest zgodna ze strukturą danych w rubrykach odpisu pełnego dostępnego w słowniku content.full_excerpt.dane.
Każdy element listy powiązań zawiera dodatkowo pola:
- nrWpisuWprow - numer wpisu do KRS wprowadzającego dane powiązanie,
- dataWpisuWprow - data wpisu do KRS wprowadzającego dane powiązanie.
Dla historycznych powiązań dostępne są również pola:
- nrWpisuWykr - numer wpisu do KRS wykreślającego dane powiązanie,
- dataWpisuWykr - data wpisu do KRS wykreślającego dane powiązanie.
Uzyskaj więcej informacji:
👉 Struktura danych w modelu pl-krs-wp-record
👉 Dokumentacja endpointów dla modelu pl-krs-wp-record
