Skip to main content
Limity są egzekwowane na poziomie konta i wynikają z aktywnego abonamentu. API jest dostępne w planie Pro i wyższym; pełną tabelę planów znajdziesz na krdata.pl/cennik. KRData używa dwóch rodzajów ograniczeń, które działają niezależnie:
  • Pule – miesięczne lub dzienne kwoty jednostek, zależne od planu (Pro / Enterprise). Pule miesięczne resetują się pierwszego dnia miesiąca, pula dzienna WPV o północy czasu warszawskiego. Przekroczenie puli zwraca HTTP 402.
  • Limity czasowe (rate limits) – zabezpieczenie anti-abuse: ile zapytań możesz wykonać na sekundę / na minutę. Te same wartości na każdym planie. Przekroczenie zwraca HTTP 429.

​
Pule miesięczne

​
Wspólna pula zapytań (lookups)

Jedna pula obejmuje wszystkie źródła danych: rejestry (KRS, CRBR, persons, graf powiązań), obwieszczenia (KRZ, MSiG, KNF, UOKiK, SUDOP), zamówienia publiczne (BZP) oraz analizę ryzyka (/v1/risk). Zasady naliczania:
  • /record, /v1/graph, /v1/risk – 1 jednostka za wywołanie.
  • /records – 1 jednostka za każdy przekazany identyfikator (do 50 naraz).
  • /stream oraz endpointy listowe (KNF, UOKiK, SUDOP) – 1 jednostka za każdą zwróconą pozycję. Wywołanie z limit=1000, które zwróci 1000 rekordów, zużyje 1000 jednostek.
  • /v1/krs/changes/stream liczony jest z rabatem: 1 jednostka za każde 10 zwróconych zmian.
GET /v1/usage/summary pokazuje rozbicie zużycia puli per źródło.

​
Sprawozdania finansowe RDF

Osobna pula jednostek RDF:
  • /v1/rdf/documents i /v1/rdf/financials – 1 jednostka za wywołanie.
  • /v1/rdf/documents/{id} (pobranie pliku sprawozdania) – 5 jednostek.
  • /v1/rdf/archive (ZIP ze wszystkimi sprawozdaniami podmiotu) – 5 jednostek za każde sprawozdanie w archiwum; przez API dostępny wyłącznie w planie Enterprise.

​
Odpisy i dokumenty PDF

Obejmuje /v1/krs/pdf/{krs} (odpis aktualny i pełny), /v1/crbr/pdf/{krs} oraz /v1/uokik/documents/{id}. Pula PDF jest wspólna dla panelu i API – pobranie odpisu z panelu zużywa tę samą pulę co wywołanie endpointu.

​
Pula dzienna – Biała Lista VAT

Obejmuje /v1/wpv/record i /v1/wpv/records (wsad do 50 identyfikatorów; każdy identyfikator to 1 zapytanie). Reset o północy czasu warszawskiego.

​
Funkcje konta

​
Endpointy poza pulami

Nie zużywają żadnej puli (obowiązują tylko limity czasowe):
  • /v1/search – wyszukiwarka podstawowa.
  • Endpointy meta: /v1/usage/*, /v1/monitors, /v1/monitor-events, /v1/updates, /v1/filters, /v1/reports/*, /v1/msig/issues.

​
Rate limits

Niezależne od planu, liczone osobno dla każdego kubełka. Przekroczenie zwraca HTTP 429 natychmiast, nawet jeśli pula miesięczna nie została wyczerpana.

​
Sprawdzanie bieżącego stanu

Odpowiedź zawiera użycie i pozostałą pulę w każdej kategorii (z rozbiciem per źródło), dzienną pulę WPV oraz datę najbliższego resetu. Dostępne są też GET /v1/usage/daily (zużycie dzień po dniu) i GET /v1/usage/breakdown (per endpoint).

​
Przekroczenie limitu

  • Pula miesięczna lub dzienna – HTTP 402 Payment Required z opisem puli w polu detail. Aby zwiększyć pule, przejdź na wyższy plan w Panel → Abonament.
  • Limit czasowy – HTTP 429 Too Many Requests. Odczekaj i ponów zapytanie. Limitów tempa nie da się podnieść – są wspólne dla wszystkich planów.