Jak to działa Dla kogo Monitoring firm Wyszukiwarka firm Profil firmy Cennik Przewodniki API Reference Changelog Aktywność rejestru
Company Snapshot API

Jedno zapytanie.
Pełny obraz firmy.

Pobierz aktualny stan dowolnej firmy z polskiego rejestru po jednym identyfikatorze - NIP, REGON lub KRS. Bez wyszukiwania, bez kryteriów. Jeden request, jedna odpowiedź, ostatni dostępny stan w rejestrze.

Dostępne przez API. W aplikacji działa monitoring – wyszukiwanie prowadzisz zapytaniem.

5 kredytów
za zapytanie
Codzienna
aktualizacja danych
180 / min
limit zapytań

Profil firmy (Company Snapshot API) to moduł do jednorazowego sprawdzenia jednej, konkretnej firmy po numerze NIP, REGON lub KRS - bez wyszukiwania, bez kryteriów, bez list. Dziś sprawdzenie kontrahenta przed podpisaniem umowy to zwykle kilka osobnych źródeł: status w KRS, adres w GUS, kto reprezentuje spółkę - każde z osobnej strony, w innym formacie, bez pewności że to ten sam moment w czasie. Profil firmy łączy to w jedno zapytanie i jedną odpowiedź: kompletny, ustrukturyzowany obraz firmy takiej, jaka jest dzisiaj w rejestrze.

cykl nocny

Pełny obraz w jednej odpowiedzi

Jedno zapytanie, dwa parametry - identifier_type i identifier_value. W odpowiedzi:

Identyfikatory i typ podmiotu

NIP i REGON, oraz typ podmiotu - osoba fizyczna czy prawna.

Nazwa, status, adres

Nazwa, status działalności, forma prawna i pełny adres siedziby.

Jednostki i oddziały

Jeśli firma je ma - z własnymi adresami i datami.

Kody PKD

Główny kod działalności oraz pozostałe.

Daty rejestrowe

Data rejestracji i inne daty zapisane w rejestrze.

Osoby powiązane z firmą

Rola w firmie (np. właściciel, wspólnik). W KRS zamaskowane u źródła, w GUS dostępne dla JDG i spółek cywilnych.

Dane kontaktowe

Jeśli są dostępne w rejestrze.

Znacznik czasu

fetched_at - moment pobrania danych, żebyś wiedział dokładnie, na jaki dzień jest ten obraz.

Firma, którą już znasz i obserwujesz na bieżąco?

Profil firmy to jednorazowy odczyt. Jeśli ta sama firma ma dla Ciebie znaczenie długoterminowo, dodaj ją do Monitoringu firm i dostawaj alerty o każdej zmianie automatycznie, zamiast odpytywać ręcznie.

Zobacz Monitoring firm →

Kiedy sięgnąć po Profil firmy

Przed podpisaniem umowy

Sprawdź kontrahenta zanim wyślesz ofertę czy podpiszesz kontrakt: status działalności, forma prawna, adres, kto ma prawo reprezentować firmę.

Onboarding klienta

Część procesu KYC - jeden request przy zakładaniu konta klienta, wynik trafia prosto do Twojego systemu.

Weryfikacja doraźna

Nie każda firma wymaga stałej obserwacji. Czasem potrzebujesz tylko odpowiedzi na „czy ta firma nadal istnieje i kto nią kieruje" - raz, teraz, bez zakładania monitoringu na przyszłość.

Response · 200 OK
{
  "status": "success",
  "data": {
    "identity": {
      "identifiers": [
        { "type": "NIP",    "value": "6121106077" },
        { "type": "REGON9", "value": "021168364"  }
      ],
      "company_type": "Osoba fizyczna"
    },
    "profiles": [
      {
        "name":       "Indywidualna Specjalistyczna Praktyka Lekarska Elżbieta Cieśla",
        "status":     "Aktywny",
        "legal_form": "OSOBY FIZYCZNE PROWADZĄCE DZIAŁALNOŚĆ GOSPODARCZĄ",
        "address":    { /* ulica, kod pocztowy, miasto, województwo */ },
        "activities": [
          { "code": "8622Z", "name": "PRAKTYKA LEKARSKA SPECJALISTYCZNA", "is_primary": true }
        ]
      }
    ],
    "persons": [
      { "full_name": "ELŻBIETA DANUTA CIEŚLA", "role": "Właściciel" }
    ]
  },
  "meta": { "fetched_at": "2026-03-24T14:48:49+00:00" }
}

Zacznij sprawdzać firmy

Od pierwszego zapytania po wyszukiwanie wielu firm naraz – gdy Profil firmy to za mało.

Najczęstsze pytania

Ile kosztuje jedno zapytanie?

5 kredytów za odpowiedź, niezależnie od tego, jak rozbudowany jest profil firmy.

Skąd pochodzą dane i jak często są aktualizowane?

Z tego samego źródła co reszta platformy - pełne odpisy KRS i rejestr GUS, odświeżane w cyklu dziennym.

Czy mogę sprawdzić wiele firm jednym zapytaniem?

Nie - jedno wywołanie zwraca dokładnie jeden profil, jednej firmy. Limit to 180 zapytań na minutę.

Czy widzę historię zmian firmy, czy tylko stan obecny?

Na ten moment tylko ostatni dostępny stan. Historyczne dane specyficzne dla spółek (po numerze KRS) są w przygotowaniu.

Czego tutaj nie znajdziesz

  • - Danych finansowych - przychodów, zysku, wielkości zatrudnienia. Rejestr tego nie zawiera.
  • - Historii zmian w czasie - to domena Monitoringu firm, nie Profil firmy.
  • - Zapytań grupowych - jeden request to jedna firma.
  • - Firm spoza polskiego rejestru - źródłem jest KRS i GUS.

Gotowy do integracji?

Pełna dokumentacja API, przewodnik po uwierzytelnianiu i opis endpointów – wszystko czego potrzebujesz żeby zacząć.