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, dokumenty).
  • CRBR — Centralny Rejestr Beneficjentów Rzeczywistych.
  • CEIDG — Centralna Ewidencja i Informacja o Działalności Gospodarczej (jednoosobowe działalności).
  • KRZ — Krajowy Rejestr Zadłużonych (postępowania, ogłoszenia).
  • MSiG — Monitor Sądowy i Gospodarczy.
  • Biała lista VAT — wyszukiwanie i weryfikacja podatników VAT.

Szybki start

  1. Załóż konto na krdata.pl/rejestracja i wybierz plan.
  2. Wygeneruj klucz API w Panel → Ustawienia → API.
  3. Wywołaj endpoint, przekazując klucz w nagłówku x-api-key:
Każdy zasób (krs, crbr, ceidg, persons, krz, msig) udostępnia 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 (do 1000) + offset.

Strumieniowa integracja i paginacja

Strumień zwraca rekordy posortowane od najnowszego. Przykład pobrania wszystkich zmian KRS z 28 maja:
Iteruj offset += 1000has_more: false. Filtry from/to w KRS i CRBR przyjmują pełny znacznik czasu (ISO 8601), w CEIDG/KRZ/MSiG — 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.