Przejdź do treści
Biznesmeni

Dla zespołów IT, compliance i ryzyka

KRS API z osobami i powiązaniami spółek

API KRS w Biznesmeni zwraca w JSON spółki z rejestru razem z ludźmi: pełne imiona i nazwiska członków zarządu, prokurentów i wspólników, role z datami od i do, procent udziałów oraz dane ze sprawozdań. Szukasz spółki po nazwie, NIP, KRS albo REGON, a osoby po imieniu i nazwisku. API jest w planach Kancelaria (5 000 zapytań w miesiącu) i Instytucja (50 000).

Zespół analityków omawia wyniki sprawdzenia kontrahenta

Sprawdź, jakie dane zwróci API

Wpisz nazwę spółki, NIP, numer KRS albo imię i nazwisko. Te same osoby, role i powiązania pierwszego poziomu zobaczysz od razu na mapie, bez zakładania konta.

Głębokość poziomy

Odpowiedź wprost

Bezpłatne API Ministerstwa Sprawiedliwości wystarczy, gdy znasz numer KRS i potrzebujesz odpisu jednego podmiotu. Imiona i nazwiska osób są w nim zamaskowane, a osoby nie da się wyszukać. Jeśli Twój system ma sprawdzać ludzi i ich spółki, potrzebujesz API, które indeksuje rejestr według osób.

Osoby po nazwisku

Zapytanie o imię i nazwisko zwraca listę osób z liczbą spółek, miastem i szacowaną wartością udziałów. Drugie zapytanie daje wszystkie role danej osoby z datami.

Spółki po NIP i KRS

Jedno pole wyszukiwania przyjmuje nazwę, NIP, numer KRS albo REGON. Profil spółki zawiera formę prawną, status, osoby z rolami i udziałami oraz przychody, zysk netto i kapitał własny z kolejnych lat.

Przewidywalny koszt

Każde zapytanie zużywa jedno z miesięcznego limitu. Nagłówki odpowiedzi podają limit i liczbę pozostałych zapytań, więc system wie, ile mu zostało, zanim dojdzie do końca okresu.

Co zwraca API KRS w Biznesmeni

API działa w stylu REST pod adresem /api/v1 i odpowiada w JSON z polskimi nazwami pól. Klucz przekazujesz w nagłówku Authorization: Bearer, a klucz tworzysz w panelu konta. Do dyspozycji są cztery zasoby.

  • GET /api/v1/spolki?q= szuka spółek po nazwie, NIP, numerze KRS albo REGON. Zwraca po 20 wyników na stronę, z polem razem i parametrem strona.
  • GET /api/v1/spolki/{slug} zwraca profil spółki: dane rejestrowe, osoby z rolą i procentem udziałów oraz sprawozdania finansowe z kolejnych lat.
  • GET /api/v1/osoby?q= szuka osób po imieniu i nazwisku, opcjonalnie z filtrem województwa.
  • GET /api/v1/osoby/{slug} zwraca wszystkie role osoby: spółkę z NIP i KRS, nazwę roli, daty od i do z informacją o precyzji daty oraz procent udziałów.

Osoby, które złożyły sprzeciw wobec przetwarzania, nie są zwracane w wynikach. To ważne, jeśli integrujesz dane z systemem, który potem przechowuje je u siebie.

KRS API Ministerstwa Sprawiedliwości a API z osobami

Oficjalne API pod adresem api-krs.ms.gov.pl jest bezpłatne i nie wymaga klucza. Zwraca odpis aktualny albo pełny jednego podmiotu, gdy podasz jego numer KRS. Sprawdziliśmy odpowiedź w październiku 2026: imiona i nazwiska członków zarządu są zamaskowane gwiazdkami, a PESEL ma widoczną tylko pierwszą cyfrę.

Co potrzebujeszAPI KRS MS (bezpłatne)API Biznesmeni
Odpis jednego podmiotu po numerze KRSTak, aktualny i pełny, w JSONProfil spółki z danymi rejestrowymi, bez treści odpisu
Wyszukiwanie spółki po nazwie albo NIPNie, tylko numer KRSTak, nazwa, NIP, KRS albo REGON
Pełne imiona i nazwiska osóbNie, zamaskowaneTak
Wyszukiwanie osoby po nazwiskuNieTak
Wszystkie spółki jednej osobyNieTak, role z datami od i do
Sprawozdania finansoweNie, osobny system eKRSPrzychody, zysk netto, kapitał własny z lat
Klucz i limitBez kluczaKlucz z panelu, 5 000 albo 50 000 zapytań w miesiącu
Cena0 złW planie Kancelaria od 745 zł netto miesięcznie przy płatności rocznej

Wiele zespołów łączy oba źródła. Oficjalne API daje treść odpisu do akt, a API z osobami odpowiada na pytanie, w jakich innych spółkach działają ludzie kontrahenta. Do danych jednoosobowych działalności służy osobny rejestr CEIDG, a do numerów REGON usługa GUS, każda z własnym kluczem.

Wdrożenie

Jak podłączyć API KRS do swojego systemu

  1. Wybierz plan z API

    API jest w planach Kancelaria i Instytucja. Zapytanie z konta bez takiego planu dostaje odpowiedź 403 z informacją, w którym planie jest dostęp.

  2. Utwórz klucz w panelu

    Pełny klucz widzisz raz, zaraz po utworzeniu, a w bazie trzymamy tylko jego skrót. Zespół może mieć do 20 aktywnych kluczy. Jeśli wycieknie, unieważniasz go w panelu i tworzysz nowy, a stary od razu przestaje działać.

  3. Wyślij pierwsze zapytanie

    Zacznij od /api/v1/spolki?q= z NIP kontrahenta. Z wyniku bierzesz slug i pobierasz profil z osobami, a dla każdej osoby jej pozostałe role.

  4. Pilnuj limitu

    Czytaj nagłówki X-Limit-Miesiac i X-Limit-Zostalo. Po wyczerpaniu limitu API zwraca 429, a przydział odnawia się z nowym okresem rozliczeniowym.

Zastosowania

Do czego zespoły używają API KRS z osobami

Onboarding klienta w instytucji obowiązanej

System przyjmujący klienta pobiera po NIP zarząd i wspólników z udziałami, zanim analityk otworzy sprawę. Analityk zaczyna od gotowej listy osób, a nie od przepisywania odpisu. Zakres obowiązków opisujemy na stronie weryfikacja AML.

Ocena ryzyka kredytu kupieckiego

Przy wniosku o limit kupiecki CRM sprawdza, w ilu innych spółkach działa prezes kontrahenta i czy któraś ma status inny niż aktywny. Wynik trafia do karty klienta obok danych o płatnościach.

Uzupełnianie danych w CRM

Dział sprzedaży dostaje w rekordzie firmy formę prawną, status, osoby decyzyjne z rolami i przychody z ostatnich lat. Handlowiec wie, z kim rozmawia, zanim zadzwoni.

Analizy kancelarii i redakcji

Przy dużej liczbie nazwisk skrypt zbiera role wszystkich osób z listy i zapisuje je do arkusza do dalszej analizy. Pojedyncze sprawy wygodniej prowadzić na mapie powiązań KRS.

Ile kosztuje API KRS w Biznesmeni

Ceny są netto, do kwoty doliczamy 23% VAT. Fakturę VAT wystawiamy od razu po płatności. W obu planach API dostajesz razem z mapą powiązań, alertami i pracą zespołu.

Kancelaria

1 490 zł miesięcznie lub 745 zł miesięcznie przy płatności rocznej

API 5 000 zapytań w miesiącu, 5 użytkowników, 3 000 map w miesiącu do 6 poziomów, rejestr czynności AML i hurtowe sprawdzenie listy NIP i KRS do 2 000 wierszy. Przy płatności rocznej jedno zapytanie kosztuje około 15 groszy netto, licząc sam abonament.

Instytucja

3 990 zł miesięcznie lub 1 995 zł miesięcznie przy płatności rocznej

API 50 000 zapytań w miesiącu, 20 użytkowników z rolami i logowaniem SSO, alerty dla 10 000 podmiotów, dziennik dostępu z retencją 5 lat, SLA 99,9% i umowa powierzenia w panelu. Jedno zapytanie przy płatności rocznej to około 4 grosze netto.

Wszystkie plany porównasz w cenniku. Jeśli potrzebujesz samej mapy bez integracji, wystarczy niższy plan opisany na stronie raport KRS.

Pytania o KRS API

Czy KRS ma API?

Tak, Ministerstwo Sprawiedliwości udostępnia bezpłatne API pod adresem api-krs.ms.gov.pl. Po podaniu numeru KRS zwraca w JSON odpis aktualny albo pełny jednego podmiotu. Nie wymaga klucza. Nie wyszukuje jednak po nazwie ani NIP, a imiona i nazwiska osób w odpowiedzi są zamaskowane.

Czy API KRS jest darmowe?

Oficjalne API KRS Ministerstwa Sprawiedliwości jest darmowe i działa bez klucza. Płatne są API firm, które przetwarzają rejestr dalej, na przykład indeksują go według osób i powiązań. W Biznesmeni API jest częścią planu Kancelaria od 745 zł netto miesięcznie przy płatności rocznej, z limitem 5 000 zapytań.

Jak wyszukać osobę w KRS przez API?

Oficjalne API KRS nie wyszukuje osób, bo przyjmuje tylko numer KRS podmiotu i maskuje dane osobowe. Do wyszukania osoby potrzebujesz API, które indeksuje rejestr według osób. W Biznesmeni zapytanie GET /api/v1/osoby?q=imię nazwisko zwraca listę osób, a profil osoby pokazuje wszystkie jej role w spółkach z datami.

Czy przez API KRS sprawdzę spółkę po NIP?

Oficjalne API KRS wymaga numeru KRS, więc po samym NIP spółki nie znajdzie. W Biznesmeni pole q w zapytaniu /api/v1/spolki przyjmuje NIP, numer KRS, REGON albo nazwę. Z wyniku bierzesz identyfikator spółki i pobierasz profil z zarządem, wspólnikami, udziałami i sprawozdaniami finansowymi.

Jaki jest limit zapytań API KRS?

W Biznesmeni plan Kancelaria ma 5 000 zapytań w miesiącu, a plan Instytucja 50 000. Każde zapytanie zużywa jedno z limitu, a nagłówki X-Limit-Miesiac i X-Limit-Zostalo pokazują stan. Po wyczerpaniu limitu API odpowiada kodem 429, a przydział odnawia się z nowym okresem rozliczeniowym.

W jakim formacie API zwraca dane z KRS?

API zwraca dane w JSON z polskimi nazwami pól, takimi jak nazwa, krs, nip, regon, rola_nazwa, od, do i udzial_procent. Listy mają stronicowanie po 20 wyników z polem razem i parametrem strona. Daty są w formacie RRRR-MM-DD, a pole precyzji mówi, czy znany jest dzień, miesiąc czy tylko rok.

Podłącz API KRS do swojego systemu

Najpierw sprawdź w wyszukiwarce u góry strony, jakie osoby i role zobaczysz dla swoich kontrahentów. Potem wybierz plan Kancelaria albo Instytucja, utwórz klucz w panelu i wyślij pierwsze zapytanie.

Wybierz plan z API
Kierowniczka działu compliance przy laptopie w sali konferencyjnej

Jak czytać role i udziały, które zwraca API, opisujemy na stronie powiązania spółek. Udziałowców i spółki matki kontrahenta rozpisuje struktura właścicielska spółki. Zmiany w rejestrze bez pisania kodu śledzi monitoring KRS, a porównanie dostępnych narzędzi znajdziesz w tekście o tym, czym zastąpić Moje Państwo KRS.