API zdarzeń w firmach z KRS i KRZ

Dostęp i klucz

API jest dostępne w planach Windykacja i Instytucja. Klucz tworzysz w panelu, w zakładce /panel/api. Pełną wartość klucza widzisz tylko raz, przy utworzeniu, więc zapisz ją od razu w bezpiecznym miejscu. Klucz możesz w każdej chwili unieważnić i utworzyć nowy.

Klucz przekazujesz w nagłówku Authorization w schemacie Bearer:

Authorization: Bearer TWOJ_KLUCZ_API

Równoważnie możesz użyć nagłówka X-Api-Key: TWOJ_KLUCZ_API. Klucza nie podaje się w adresie zapytania. Parametr key, api_key, klucz albo token w adresie kończy się kodem 400, żeby klucz nie trafiał do logów serwerów pośredniczących i historii przeglądarki.

Adres bazowy API to https://biznesmeni.info/api/v1. Wszystkie odpowiedzi są w JSON, kodowanie UTF-8, daty w formacie RRRR-MM-DD.

Pobieranie zdarzeń

GET https://biznesmeni.info/api/v1/zdarzenia

Zwraca zdarzenia od najnowszych, posortowane po dacie zdarzenia malejąco, a przy tej samej dacie po id malejąco. Wszystkie parametry są opcjonalne i można je łączyć. Bez parametrów dostajesz najnowsze zdarzenia z całego kanału. Zakres historii zależy od planu: w planie Windykacja to ostatnie 60 miesięcy, w planie Instytucja cała historia w bazie. Data od wcześniejsza niż początek historii planu jest przesuwana do tego początku.

Parametry zapytania

Rodzaj albo grupa spoza listy dają pustą odpowiedź, a nie wszystkie zdarzenia. Inaczej jest z województwem i formą prawną: wartość spoza listy jest pomijana, więc wynik obejmuje wtedy cały kraj albo wszystkie formy. Sprawdź pisownię, zanim zasilisz wynikiem swój system. Parametry o innych nazwach są ignorowane.

Grupy i rodzaje zdarzeń

Lista rodzajów w API

Aktualną listę grup i rodzajów z nazwami zwraca osobny adres. Przydaje się do budowy filtrów po twojej stronie. To zapytanie też zużywa jedną pozycję z puli.

GET https://biznesmeni.info/api/v1/rodzaje

{
  "grupy": {
    "upadlosci": [
      { "klucz": "upadlosc_wniosek", "nazwa": "wniosek o ogłoszenie upadłości" },
      { "klucz": "upadlosc_ogloszona", "nazwa": "ogłoszenie upadłości" }
    ]
  }
}

Przykład zapytania

Ogłoszone upadłości i otwarte restrukturyzacje spółek z o.o. z województwa śląskiego z ostatnich 7 dni:

curl -G "https://biznesmeni.info/api/v1/zdarzenia" \
  -H "Authorization: Bearer TWOJ_KLUCZ_API" \
  --data-urlencode "rodzaje[]=upadlosc_ogloszona" \
  --data-urlencode "rodzaje[]=restrukturyzacja" \
  -d "wojewodztwo=slaskie" \
  -d "forma=sp_zoo" \
  -d "dni=7"

Wszystkie zdarzenia jednej firmy po numerze NIP od początku miesiąca:

curl -G "https://biznesmeni.info/api/v1/zdarzenia" \
  -H "Authorization: Bearer TWOJ_KLUCZ_API" \
  -d "q=5252000000" \
  -d "od=2026-10-01"

Odpowiedź

Odpowiedź zawiera numer strony, liczbę zdarzeń na stronie, łączną liczbę zdarzeń pasujących do filtra i listę zdarzeń w polu dane.

{
  "strona": 1,
  "na_strone": 100,
  "razem": 1,
  "dane": [
    {
      "id": 418230,
      "data": "2026-10-16",
      "rodzaj": "upadlosc_ogloszona",
      "nazwa_rodzaju": "ogłoszenie upadłości",
      "grupa": "upadlosci",
      "firma": {
        "nazwa": "NAZWA SPÓŁKI SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ",
        "krs": "0000123456",
        "nip": "5250000000",
        "forma": "spółka z o.o.",
        "url": "https://biznesmeni.info/spolki/nazwa-spolki",
        "email": null,
        "www": null
      },
      "osoba": null,
      "region": "śląskie, Katowice",
      "branza": "Roboty budowlane związane ze wznoszeniem budynków",
      "szczegol": "Sąd ogłosił upadłość spółki i wyznaczył syndyka.",
      "rejestr": "Krajowy Rejestr Zadłużonych",
      "sygnatura": "KA1K/GUp/123/2026",
      "termin_wierzytelnosci": "2026-11-15",
      "url": "https://biznesmeni.info/spolki/nazwa-spolki/zmiany#z418230"
    }
  ]
}

Wartości w przykładzie pokazują format pól, a nie konkretną firmę.

Pola zdarzenia

Paginacja

Wynik dzielimy na strony. Pole razem podaje łączną liczbę zdarzeń dla filtra, więc liczbę stron wyliczysz jako razem podzielone przez na_strone, w górę. Kolejną stronę pobierasz parametrem strona. Przy codziennym pobieraniu najprościej zapytać o zdarzenia z ostatnich dni i pominąć te, których id już masz.

Limity planów

Każde zapytanie zużywa jedną pozycję z puli okresu, także zapytanie z pustym wynikiem. Pula wraca w całości z nowym okresem rozliczeniowym. Każda odpowiedź ma nagłówki X-Limit-Okres (pula okresu) i X-Limit-Zostalo (ile zapytań zostało), więc łatwo pilnować zużycia po swojej stronie. Odpowiedź 429 też je zawiera.

Kody odpowiedzi i błędy

Błędna wartość parametru nie kończy się błędem. Nieznany rodzaj daje pustą listę, a nieznane województwo albo forma prawna są pomijane, dlatego warto porównać wynik z tabelami wyżej. Treść błędu przychodzi w polu blad:

{
  "blad": "Klucz API jest nieprawidłowy albo został unieważniony."
}

Dobre praktyki

• Trzymaj klucz po stronie serwera. Nie umieszczaj go w kodzie strony ani aplikacji mobilnej.
• Pobieraj zdarzenia raz albo kilka razy dziennie z filtrem dni zamiast odpytywać pojedyncze firmy w pętli.
• Dla portfela dłużników wygodniej użyć obserwowanych firm i alertów w panelu, a API zostawić do zasilania własnego systemu.
• Pamiętaj o zasadach korzystania z danych z regulaminu, także przy danych osobowych w polu osoba.