Baza wiedzy o serwisach administracji publicznej

Ministerstwo Sprawiedliwości udostępnia otwarte API Krajowego Rejestru Sądowego pod adresem api-krs.ms.gov.pl. Pozwala ono automatycznie pobierać odpisy aktualne i pełne w formacie JSON oraz biuletyny zmian. To dobra wiadomość dla organizacji budujących narzędzia przejrzystości, systemy CRM czy rejestry – dane można aktualizować bez ręcznego kopiowania.

Najważniejsze zapytania

Odpis aktualny pobierasz, podając numer KRS i rejestr: literę P dla rejestru przedsiębiorców albo S dla rejestru stowarzyszeń. Odpis pełny pobierasz analogicznie, zmieniając nazwę zasobu. Biuletyn dzienny zwraca listę numerów KRS, w których w danym dniu dokonano zmian, a biuletyn godzinowy zawęża wynik do przedziału godzin. Zapytania o biuletyny przyjmują daty późniejsze niż 8 grudnia 2021 r.

GET https://api-krs.ms.gov.pl/api/krs/OdpisAktualny/{numerKRS}?rejestr={P|S}&format=json
GET https://api-krs.ms.gov.pl/api/krs/OdpisPelny/{numerKRS}?rejestr={P|S}&format=json
GET https://api-krs.ms.gov.pl/api/Krs/Biuletyn/{dzien}
GET https://api-krs.ms.gov.pl/api/Krs/BiuletynGodzinowy/{dzien}?godzinaOd={HH}&godzinaDo={HH}

Przykład: aby pobrać odpis aktualny fundacji wpisanej do rejestru stowarzyszeń, wystarczy zapytanie do zasobu OdpisAktualny z jej numerem KRS i parametrem rejestr=S. Typowy scenariusz integracji to codzienne pobieranie biuletynu, porównanie listy zmienionych numerów KRS z własną bazą i pobranie odpisów tylko dla tych podmiotów. Pytania dotyczące API kieruje się pod adres [email protected].

Dobra praktyka. Ogranicz liczbę zapytań do niezbędnego minimum, zapisuj wyniki w pamięci podręcznej i obsługuj błędy serwera. Pamiętaj, że dane osobowe członków organów pobrane z API podlegają przepisom o ochronie danych – przetwarzaj je tylko w zakresie potrzebnym do celu.