Skip to main content
krdata udostępnia dane z polskich rejestrów gospodarczych w postaci jednego, spójnego REST API:
  • KRS – Krajowy Rejestr Sądowy (firmy, członkowie organów, wspólnicy, historia zmian, odpisy PDF).
  • CRBR – Centralny Rejestr Beneficjentów Rzeczywistych.
  • KRZ – Krajowy Rejestr Zadłużonych (postępowania, obwieszczenia).
  • MSiG – Monitor Sądowy i Gospodarczy.
  • BZP – Biuletyn Zamówień Publicznych (ogłoszenia o zamówieniach).
  • RDF – sprawozdania finansowe z Repozytorium Dokumentów Finansowych (dokumenty źródłowe i sparsowane dane liczbowe).
  • KNF – komunikaty i lista ostrzeżeń publicznych.
  • UOKiK – decyzje Prezesa UOKiK i zgłoszenia koncentracji.
  • SUDOP – pomoc publiczna udzielona podmiotom.
  • Biała lista VAT – weryfikacja podatników VAT i rachunków bankowych.
Ponadto API udostępnia funkcje analityczne: graf powiązań (/v1/graph), analizę ryzyka podmiotu (/v1/risk), monitoring podmiotów (/v1/monitors), przyrostowy feed zdarzeń (/v1/updates) oraz raporty dzienne i na żądanie (/v1/reports).

​
Szybki start

Dostęp do API wymaga planu Pro lub wyższego. Plan Standard obejmuje wyłącznie panel.
  1. Załóż konto na krdata.pl/rejestracja i wybierz plan Pro lub Enterprise.
  2. Wygeneruj klucz API w Panel → Ustawienia → API.
  3. Wywołaj endpoint, przekazując klucz w nagłówku x-api-key:

​
Warianty endpointów

Główne źródła (krs, crbr, krz, msig, bzp) udostępniają trzy warianty:
  • /record – pojedynczy zasób po identyfikatorze (KRS/NIP/REGON/PESEL/UUID).
  • /records – wsadowe pobranie wielu zasobów jednym wywołaniem (do 50 identyfikatorów; parametry można powtarzać: ?krs=A&krs=B&nip=C).
  • /stream – strumień bez filtru po podmiocie, posortowany po dacie aktualizacji/publikacji. Domyślnie zwraca pełny rekord (KrsRecord, KrzAnnouncement, itd.) – identyczny jak /record. include_details=false przełącza na lekki shape. Paginacja limit (domyślnie 20, do 1000) + offset.
persons ma warianty /record i /records (bez strumienia). Historia zmian KRS ma własny strumień /v1/krs/changes/stream oraz widok per podmiot /v1/krs/changes/{identifier}. Pozostałe źródła (RDF, KNF, UOKiK, SUDOP, WPV) mają endpointy listowe opisane w sekcji API Reference.

​
Strumieniowa integracja i paginacja

Strumień zwraca rekordy posortowane od najnowszego. Przykład pobrania wszystkich zmian KRS z 28 maja:
Iteruj offset += 1000 aż has_more: false. Filtry from/to w KRS i CRBR przyjmują pełny znacznik czasu (ISO 8601), w KRZ/MSiG/BZP – datę (dane źródłowe są dzienne). Unikanie dryfu offsetu na żywym strumieniu: offset-paginacja jest niespójna gdy nowe rekordy dochodzą między stronami (strona 2 może powtórzyć ostatni wiersz ze strony 1). Rozwiązanie: zamroź zakres to na konkretny moment – to=<znacznik startu> – i paginuj w jego obrębie. Następne pollowanie zaczynaj od from=<znacznik startu> z poprzedniego cyklu. Pełna lista endpointów znajduje się w sekcji API Reference.