API KRS: jak korzystać, odpisy i biuletyn zmian

2026-10-21 · SzopaLabs

Otwarte API KRS krok po kroku: adresy OdpisAktualny i OdpisPelny, parametry, struktura JSON, biuletyn zmian, kody odpowiedzi, limity i maskowanie danych osób.

Programista tworzy zapytanie do otwartego API KRS

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 rejestr ma wartość P (przedsiębiorcy) albo S (stowarzyszenia, fundacje i inne organizacje). Bez parametru API szuka w rejestrze P, więc fundacja bez rejestr=S zwró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

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

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:

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ć:

Typowy schemat monitorowania listy kontrahentów:

  1. Codziennie rano pobierz biuletyn z poprzedniego dnia.
  2. Uzupełnij numery do 10 cyfr i usuń duplikaty.
  3. Porównaj z listą swoich kontrahentów.
  4. 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:

  1. Rób przerwy. My przy pobieraniu wsadowym robimy 0,4 s przerwy między zapytaniami.
  2. Przechowuj odpisy. Dane spółki nie zmieniają się co godzinę. Zamiast pytać codziennie o wszystkich, korzystaj z biuletynu i pobieraj tylko zmienione spółki.
  3. Zapisuj dataCzasOdpisu i stanZDnia. Gdy trzeba będzie wykazać, na jakiej podstawie zawarto umowę, ta informacja się przyda.
  4. Ustaw timeout i ponawianie przy 5xx. Skrypt, który wisi bez końca, zablokuje cały import.
  5. 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:

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.

  1. 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.
  2. 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.
  3. Zapisuj datę pobrania w osobnym polu przy każdym rekordzie.
  4. 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:

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.

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

Rekomendacje

Przygotowane z pomocą AI, sprawdził M. Szopa, stan prawny na 8 listopada 2026. Wpis ma charakter informacyjny i nie stanowi porady prawnej ani podatkowej.

← Wszystkie wpisy