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).
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.
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 polemrazemi parametremstrona.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.
GET /api/v1/osoby/jan-kowalski-1
Authorization: Bearer ••••••••
HTTP/1.1 200
X-Limit-Miesiac: 5000
X-Limit-Zostalo: 4812
{
"dane": {
"imie": "Jan",
"nazwisko": "Kowalski",
"miasto": "Poznań",
"liczba_spolek": 3,
"role": [
{
"spolka": { "nazwa": "…", "krs": "…", "nip": "…" },
"rola_nazwa": "Prezes zarządu",
"od": "2019-03-14",
"do": null,
"udzial_procent": 40
}
]
}
}
Układ odpowiedzi z dokumentacji. Dane osoby w przykładzie są fikcyjne.
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 potrzebujesz | API KRS MS (bezpłatne) | API Biznesmeni |
|---|---|---|
| Odpis jednego podmiotu po numerze KRS | Tak, aktualny i pełny, w JSON | Profil spółki z danymi rejestrowymi, bez treści odpisu |
| Wyszukiwanie spółki po nazwie albo NIP | Nie, tylko numer KRS | Tak, nazwa, NIP, KRS albo REGON |
| Pełne imiona i nazwiska osób | Nie, zamaskowane | Tak |
| Wyszukiwanie osoby po nazwisku | Nie | Tak |
| Wszystkie spółki jednej osoby | Nie | Tak, role z datami od i do |
| Sprawozdania finansowe | Nie, osobny system eKRS | Przychody, zysk netto, kapitał własny z lat |
| Klucz i limit | Bez klucza | Klucz z panelu, 5 000 albo 50 000 zapytań w miesiącu |
| Cena | 0 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
-
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.
-
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ć.
-
Wyślij pierwsze zapytanie
Zacznij od
/api/v1/spolki?q=z NIP kontrahenta. Z wyniku bierzeszslugi pobierasz profil z osobami, a dla każdej osoby jej pozostałe role. -
Pilnuj limitu
Czytaj nagłówki
X-Limit-MiesiaciX-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
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.