API KRS: jak korzystać, odpisy i biuletyn zmian
Otwarte API KRS krok po kroku: adresy OdpisAktualny i OdpisPelny, parametry, struktura JSON, biuletyn zmian, kody odpowiedzi, limity i maskowanie danych osób.
Otwarte API KRS Ministerstwa Sprawiedliwości jest bezpłatne i nie wymaga rejestracji ani klucza. Odpis aktualny spółki pobierzesz jednym zapytaniem GET: https://api-krs.ms.gov.pl/api/krs/OdpisAktualny/{numer KRS}?rejestr=P&format=json. W odpowiedzi dostajesz JSON z działami 1–6 odpisu. API ma cztery usługi: odpis aktualny, odpis pełny oraz biuletyn zmian, dzienny i godzinowy. Oficjalny opis jest na Portalu Rejestrów Sądowych. Poniżej zebraliśmy to, czego tam nie ma, a co sprawdziliśmy na żywym API 8 listopada 2026 r.
Krótko mówiąc:
- Pytasz zawsze o jeden numer KRS. API nie szuka po NIP-ie ani po nazwie, więc numer KRS dla NIP-u ustal najpierw, na przykład na białej liście VAT.
- Parametr
rejestrma wartość P (przedsiębiorcy) albo S (stowarzyszenia, fundacje i inne organizacje). Bez parametru API szuka w rejestrze P, więc fundacja bezrejestr=Szwróci 404.- Imiona, nazwiska i PESEL członków organów są zamaskowane gwiazdkami, np. „F*****”. Widać funkcję, ale nie widać, kto ją pełni.
- Opis zbioru na dane.gov.pl mówi, że API „nie posiada limitów pobrań”. Mimo to rób przerwy między zapytaniami i przechowuj pobrane odpisy.
Spis treści
- Cztery usługi otwartego API KRS
- Pierwsze zapytanie: przeglądarka, curl, Python
- Parametry i kody odpowiedzi
- Co przychodzi w odpowiedzi JSON
- Biuletyn zmian: które spółki zmieniły się danego dnia
- Limity i dobre praktyki
- API KRS, eKRS i wyszukiwarka KRS: czym się różnią
- Integracja KRS z CRM
- Czego API KRS Ci nie powie
- Gotowy raport zamiast kodu
- Najczęściej zadawane pytania
- Źródła
Cztery usługi otwartego API KRS
Ministerstwo Sprawiedliwości uruchomiło otwarte API KRS 8 marca 2022 r., na podstawie ustawy o otwartych danych. Zakres danych odpowiada odpisom z KRS, aktualnemu i pełnemu, z uwzględnieniem RODO.
| Usługa | Adres (GET) | Co zwraca |
|---|---|---|
| Odpis aktualny | https://api-krs.ms.gov.pl/api/krs/OdpisAktualny/{krs}?rejestr={P albo S}&format=json |
stan podmiotu na dziś |
| Odpis pełny | https://api-krs.ms.gov.pl/api/krs/OdpisPelny/{krs}?rejestr={P albo S}&format=json |
całą historię wpisów |
| Biuletyn dzienny | https://api-krs.ms.gov.pl/api/Krs/Biuletyn/{RRRR-MM-DD} |
listę numerów KRS ze zmianami danego dnia |
| Biuletyn godzinowy | https://api-krs.ms.gov.pl/api/Krs/BiuletynGodzinowy/{RRRR-MM-DD}?godzinaOd={GG}&godzinaDo={GG} |
listę numerów KRS ze zmianami w wybranych godzinach |
Biuletyny działają dla dni późniejszych niż 8 grudnia 2021 r. Dla wcześniejszej daty API odpowiada kodem 400.
Pierwsze zapytanie: przeglądarka, curl, Python
Nie potrzebujesz programisty, żeby zobaczyć, jak działa API. Wystarczy wkleić adres do przeglądarki:
https://api-krs.ms.gov.pl/api/krs/OdpisAktualny/0000028860?rejestr=P&format=json
To samo z wiersza poleceń:
curl "https://api-krs.ms.gov.pl/api/krs/OdpisAktualny/0000028860?rejestr=P&format=json"
I prosty skrypt w Pythonie, który pobiera nazwę i NIP. Przy fundacjach i stowarzyszeniach próbuje drugiego rejestru:
import requests
def odpis_krs(numer):
numer = str(numer).zfill(10)
for rejestr in ("P", "S"):
url = f"https://api-krs.ms.gov.pl/api/krs/OdpisAktualny/{numer}"
r = requests.get(url, params={"rejestr": rejestr, "format": "json"}, timeout=20)
if r.status_code == 404:
continue
r.raise_for_status()
return r.json()
return None
dane = odpis_krs(28860)
if dane:
podmiot = dane["odpis"]["dane"]["dzial1"]["danePodmiotu"]
print(podmiot["nazwa"], podmiot["identyfikatory"].get("nip"))
Numer KRS ma 10 cyfr z zerami na początku. W naszych testach API przyjmowało też numer bez zer (28860), ale w odpowiedzi zawsze zwraca pełne 10 cyfr. Dlatego w bazie trzymaj numer z zerami.
Parametry i kody odpowiedzi
{krs}: numer podmiotu w KRS.rejestr: P to rejestr przedsiębiorców, S to rejestr stowarzyszeń, innych organizacji społecznych i zawodowych, fundacji oraz SP ZOZ. Bez tego parametru API szuka w rejestrze P.format: według dokumentacji zawsze dostaniesz JSON, bez względu na wpisaną wartość.
| Kod | Kiedy | Co zrobić |
|---|---|---|
| 200 | odpis albo biuletyn zwrócony | zapisz dane i datę pobrania |
| 404 | nie ma takiego numeru w tym rejestrze | sprawdź numer i drugi rejestr (P/S) |
| 400 | błędne zapytanie, np. biuletyn sprzed 9 grudnia 2021 r. | popraw parametry |
| 5xx | błąd usługi | ponów później z rosnącą przerwą |
Odpowiedzi z błędem też są w JSON-ie, z polami title i status. Dokumentacja wymienia tylko kody 200, 404 i 5xx. Kod 400 API zwraca przy błędnej dacie biuletynu (sprawdzone 8 listopada 2026 r.).
Co przychodzi w odpowiedzi JSON
Odpis aktualny ma trzy części: rodzaj („Aktualny”), nagłówek naglowekA i dane z działami. W nagłówku są między innymi numer KRS, data i godzina odpisu (dataCzasOdpisu), stan na dzień (stanZDnia), data rejestracji w KRS oraz numer i data ostatniego wpisu.
| Dział | Co w nim znajdziesz | Do czego się przydaje |
|---|---|---|
| Dział 1 | nazwa, forma prawna, NIP, REGON, siedziba i adres, kapitał, wspólnicy spółek z o.o. | uzupełnienie karty firmy, weryfikacja danych z faktury |
| Dział 2 | organ reprezentacji i jego skład (funkcje), sposób reprezentacji, prokurenci, rada nadzorcza | czy do podpisu potrzeba dwóch osób; same nazwiska są zamaskowane |
| Dział 3 | przedmiot działalności (PKD), wzmianki o złożonych sprawozdaniach finansowych | czy firma robi to, co deklaruje, i czy składa sprawozdania |
| Dział 4 | zaległości, wierzytelności, informacje o egzekucji | wczesny sygnał problemów z płynnością |
| Dział 5 | kurator | sygnał, że spółka nie ma działającego organu |
| Dział 6 | likwidacja, rozwiązanie, upadłość, połączenia, podziały i przekształcenia | czy w ogóle warto podpisywać umowę |
Pięć rzeczy, które warto wiedzieć, zanim przeniesiesz te pola do arkusza czy bazy:
- Daty to tekst w formacie DD.MM.RRRR, np. „09.10.2026”. Przed zapisem zamień je na daty.
- Kwoty to tekst z przecinkiem, np. kapitał „1451177561,25” z osobnym polem waluty. Przed liczeniem zamień je na liczby.
- PKD jest w trzech polach:
kodDzial,kodKlasa,kodPodklasa. Kod 19.20.Z składasz z „19”, „20” i „Z”. - Dane osób są zamaskowane. W składzie zarządu widać na przykład nazwisko „F*****”, imię „I*******” i PESEL „5**********” obok funkcji „PREZES ZARZĄDU”. Pełnych danych reprezentantów do umowy nie weźmiesz z API.
- Odpis pełny ma inną budowę. Nagłówek nazywa się
naglowekP, a prawie każde pole jest listą wersji z numerem wpisu, który je wprowadził (nrWpisuWprow), i tym, który je wykreślił (nrWpisuWykr). Aktualna wartość nie manrWpisuWykr. Odpis pełny jest też dużo większy: dla dużej spółki giełdowej odpis aktualny miał 63 KB, a pełny 435 KB.
Biuletyn zmian: które spółki zmieniły się danego dnia
Biuletyn to najprostszy sposób na śledzenie zmian bez codziennego odpytywania wszystkich spółek. Zwraca tablicę numerów KRS, w których danego dnia (albo w danych godzinach) dokonano wpisu.
Dwie rzeczy, na które trzeba uważać:
- Numery są bez zer na początku, np. „28860” zamiast „0000028860”. Przed porównaniem z bazą uzupełnij je do 10 cyfr.
- Numery się powtarzają. Biuletyn z 6 listopada 2026 r. miał 4249 pozycji, ale tylko 2783 różne numery, bo spółka z kilkoma wpisami jednego dnia pojawia się kilka razy. Usuń duplikaty przed pobieraniem odpisów.
Typowy schemat monitorowania listy kontrahentów:
- Codziennie rano pobierz biuletyn z poprzedniego dnia.
- Uzupełnij numery do 10 cyfr i usuń duplikaty.
- Porównaj z listą swoich kontrahentów.
- Dla spółek z części wspólnej pobierz odpis aktualny i porównaj z poprzednią wersją, zwłaszcza dział 2 (reprezentacja) i dział 6 (likwidacja, upadłość).
Do biuletynu trafia także wzmianka o złożeniu sprawozdania finansowego, więc nie każda pozycja oznacza istotną zmianę. Tak samo budujemy własny słownik spółek: biuletyny od czerwca 2025 r. dały ok. 730 tys. unikalnych numerów KRS. Więcej o pobieraniu hurtowym piszemy w tekście o otwartych danych o firmach.
Limity i dobre praktyki
W opisie zbioru na dane.gov.pl ministerstwo podaje, że API „nie wymaga tokenu i nie posiada limitów pobrań”. Odpowiedzi nie zawierają też nagłówków z limitami. Nie znaczy to, że warto zasypywać rejestr zapytaniami:
- Rób przerwy. My przy pobieraniu wsadowym robimy 0,4 s przerwy między zapytaniami.
- Przechowuj odpisy. Dane spółki nie zmieniają się co godzinę. Zamiast pytać codziennie o wszystkich, korzystaj z biuletynu i pobieraj tylko zmienione spółki.
- Zapisuj
dataCzasOdpisuistanZDnia. Gdy trzeba będzie wykazać, na jakiej podstawie zawarto umowę, ta informacja się przyda. - Ustaw timeout i ponawianie przy 5xx. Skrypt, który wisi bez końca, zablokuje cały import.
- Korzystaj z API, a nie z wyszukiwarki. Automatyczne pobieranie odpisów z wyszukiwarki KRS przez boty to co innego niż korzystanie z otwartego API, które udostępniono właśnie do ponownego wykorzystania danych.
API KRS, eKRS i wyszukiwarka KRS: czym się różnią
Wiele osób szuka „eKRS API”. W praktyce chodzi o trzy różne miejsca:
- Otwarte API KRS (
api-krs.ms.gov.pl) zwraca dane w formacie JSON, przeznaczone dla programów. Nie wydaje dokumentu urzędowego. - Wyszukiwarka KRS pozwala bezpłatnie pobrać odpis aktualny lub pełny w PDF. Takiego odpisu używa się w dokumentach, na przykład w przetargu.
- Portal Rejestrów Sądowych służy do składania wniosków i dokumentów do KRS. Tam też jest opis otwartego API.
Sprawozdania finansowe są osobno, w Repozytorium Dokumentów Finansowych. API KRS pokazuje tylko wzmiankę o ich złożeniu.
Integracja KRS z CRM
Najczęstszy scenariusz: handlowiec wpisuje NIP kontrahenta, a system sam uzupełnia nazwę, adres, sposób reprezentacji i PKD.
- Zamień NIP na numer KRS. API KRS przyjmuje tylko numer KRS, a w CRM masz zwykle NIP. Numer KRS dla NIP-u podaje API białej listy VAT albo baza REGON w GUS. Jednoosobowe działalności nie mają numeru KRS: ich dane są w CEIDG.
- Ustal, które pola nadpisuje rejestr. Rejestr jest źródłem, CRM odbiorcą. Rejestr nadpisuje nazwę, formę prawną, adres, NIP, REGON, KRS, PKD, sposób reprezentacji i informację o likwidacji lub upadłości. Opiekun, etap rozmów, notatki i osoby kontaktowe zostają w rękach zespołu.
- Zapisuj datę pobrania w osobnym polu przy każdym rekordzie.
- Odświeżaj według biuletynu, a dodatkowo zawsze przed podpisaniem umowy, wysłaniem oferty czy wystawieniem dużej faktury.
Pamiętaj, że API nie poda nazwisk członków zarządu. Osoby kontaktowe i reprezentantów do umowy wpisujesz z dokumentów od kontrahenta albo z odpisu z wyszukiwarki KRS. Jak przetwarzać dane z rejestrów zgodnie z RODO, opisujemy w tekście o wzbogacaniu danych z rejestrów.
Czego API KRS Ci nie powie
Odpis z KRS pokazuje, czym jest spółka i jak ją reprezentować. Wielu pytań, które warto zadać przed umową, nie rozstrzyga:
- status VAT i rachunki bankowe są na białej liście VAT. Jak ją sprawdzić, opisujemy w tekście o weryfikacji NIP;
- postępowania upadłościowe i restrukturyzacyjne szybciej zobaczysz w Krajowym Rejestrze Zadłużonych. Opisujemy to w poradniku jak sprawdzić upadłość firmy;
- treść sprawozdań finansowych jest w Repozytorium Dokumentów Finansowych;
- pozwolenia na budowę są w rejestrze GUNB;
- powiązania między spółkami musisz złożyć sam, zestawiając wspólników z wielu odpisów. Członków zarządu przez API nie powiążesz, bo ich dane są zamaskowane.
Gotowy raport zamiast kodu
Jeśli sprawdzasz jedną czy dwie spółki i nie chcesz pisać skryptu, przygotujemy sprawdzenie kontrahenta po NIP. Raport obejmuje wyłącznie spółki z KRS. Zestawiamy dane z KRS (także z działu 6), białej listy VAT, ogłoszenia w MSiG i pozwolenia na budowę, a przy każdej informacji wskazujemy źródło.
- Wstępny wynik dostajesz od nas za darmo.
- Pełny raport PewnyDeweloper kosztuje 49 zł jednorazowo, bez abonamentu i bez zakładania konta.
Raport to zestaw faktów z rejestrów, a nie porada prawna ani podatkowa.
Najczęściej zadawane pytania
Czy API KRS jest płatne i czy trzeba mieć klucz?
Nie. Otwarte API KRS jest bezpłatne i nie wymaga rejestracji, logowania ani klucza. Wystarczy zapytanie GET pod adres api-krs.ms.gov.pl z numerem KRS.
Jak wygląda adres zapytania OdpisAktualny?
https://api-krs.ms.gov.pl/api/krs/OdpisAktualny/0000028860?rejestr=P&format=json. Zamiast 0000028860 wstaw 10-cyfrowy numer KRS, a przy fundacji lub stowarzyszeniu użyj rejestr=S. Odpis pełny pobierzesz, zamieniając OdpisAktualny na OdpisPelny.
Jakie są limity zapytań do API KRS?
Według opisu zbioru na dane.gov.pl API nie ma limitów pobrań ani tokenu, a dokumentacja nie wymienia kodu 429. Mimo to rób przerwy między zapytaniami i korzystaj z biuletynu zmian zamiast codziennie pobierać wszystkie odpisy.
Czy mogę wyszukać firmę w API KRS po NIP albo nazwie?
Nie. API przyjmuje tylko numer KRS. Jeśli masz NIP, numer KRS sprawdzisz na białej liście VAT albo w bazie REGON, a potem zapytasz API.
Gdzie jest dokumentacja i specyfikacja API KRS?
Na Portalu Rejestrów Sądowych, pod adresem prs.ms.gov.pl/krs/openApi. Są tam adresy czterech usług, parametry i kody odpowiedzi. Struktury JSON dokumentacja nie rozpisuje. Opisujemy ją wyżej na podstawie prawdziwych odpowiedzi.
Dlaczego nazwiska członków zarządu mają gwiazdki?
API udostępnia dane z KRS z uwzględnieniem RODO, dlatego imiona, nazwiska i PESEL osób są zamaskowane do pierwszej litery lub cyfry. Imiona i nazwiska reprezentantów znajdziesz w odpisie PDF z wyszukiwarki KRS.
Czy dane z API KRS mają moc dokumentu urzędowego?
Nie. JSON z API to dane do pracy w systemach. Jeśli zamawiający w przetargu wymaga odpisu lub informacji z KRS, pobierz odpis z wyszukiwarki KRS i sprawdź w dokumentach zamówienia, w jakiej formie go złożyć.
Źródła
- Otwarte API KRS: usługi, parametry i kody odpowiedzi (Portal Rejestrów Sądowych)
- Uruchomienie otwartego API KRS, 8 marca 2022 r. (Ministerstwo Sprawiedliwości)
- API KRS: opis zbioru (dane.gov.pl)
- Wyszukiwarka KRS (Ministerstwo Sprawiedliwości)
- Repozytorium Dokumentów Finansowych
Rekomendacje
- Otwarte dane o firmach: CEIDG API, KRS, GUS
- Weryfikacja NIP i VAT: biała lista, VIES, KRS
- Ochrona 100 kontrahentów: monitorowanie KRS dla biur rachunkowych
- Wzbogacanie danych z rejestrów: jak robić to szybko i zgodnie z RODO
Przygotowane z pomocą AI, sprawdził M. Szopa, stan prawny na 8 listopada 2026. Wpis ma charakter informacyjny i nie stanowi porady prawnej ani podatkowej.