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 wyszukać przez API podmioty z KRS powiązane ze wskazaną osobą na podstawie jej numeru PESEL.
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 podmiotów z KRS powiązanych z daną osobą wymaga podania w parametrze identifiers.pl_pesel.full numeru PESEL tej osoby.
Przykład wywołania endpointu Get Records z numerem PESEL:
GET /v1/models/pl-krs-wp-record/records?identifiers.pl_pesel.full=[numer PESEL] HTTP/1.1
Host: api.mgbi.pl
Authorization: [klucz autoryzacji]
Jeżeli interesują Cię tylko podmioty, z którymi wskazana osoba posiada aktualnie jakieś relacje biznesowe, możesz też alternatywnie użyć parametru identifiers.pl_pesel.current.
Krok 3: Odczytaj z odpowiedzi dane podmiotów
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 lub więcej rekordów:
{
"count": [liczba wyników],
"pages": [liczba stron wyników],
"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]
},
...
]
}
Każdy element listy results zawiera rekord z danymi pojedynczego podmiotu zarejestrowanego w KRS, z którym osoba o podanym numerze PESEL jest lub była w przeszłości powiązana.
Możesz z niego odczytać odczytać wszystkie informacje dostępne w odpisie aktualnym lub pełnym dla tego podmiotu.
Uzyskaj więcej informacji:
👉 Struktura danych w modelu pl-krs-wp-record
👉 Dokumentacja endpointów dla modelu pl-krs-wp-record
