API KRS ze sprawozdaniami finansowymi i wyszukiwaniem spółek po NIP
Oficjalne API KRS zwraca odpis po numerze KRS, ale bez liczb ze sprawozdań i z nazwiskami ukrytymi gwiazdkami. Nasze API REST szuka spółki po NIP, KRS albo nazwie i w jednej odpowiedzi JSON oddaje przychody, zysk netto i kapitał własny z kolejnych lat, zarząd, wspólników z udziałami oraz inne spółki tych osób. Dostęp od planu Firma, 20 000 zapytań miesięcznie.
Wpisz NIP spółki i zobacz w profilu te same dane, które zwraca API.
4 metody
GET dla list i profili osób oraz spółek
20 000
zapytań miesięcznie w planie Firma
200 000
zapytań miesięcznie w planie Instytucja
NIP, KRS
albo nazwa spółki w jednym parametrze q
Krótka odpowiedź
Czego nie ma w oficjalnym API KRS
API KRS prowadzone przez Ministerstwo Sprawiedliwości jest bezpłatne i dobrze sprawdza się, gdy znasz numer KRS i potrzebujesz aktualnego odpisu w JSON. Przy scoringu, onboardingu klientów albo zasilaniu CRM szybko trafia się na trzy braki. Nie ma wyszukiwania po NIP ani po nazwie, bo jedynym kluczem jest numer KRS. Nie ma liczb ze sprawozdań, tylko wzmianki o ich złożeniu. Dane osób w zarządzie i wśród wspólników są zamaskowane, więc nie połączysz prezesa z innymi spółkami.
Zespoły, które to obchodzą samodzielnie, utrzymują trzy procesy: zamianę NIP na KRS, pobieranie i parsowanie plików XML z Repozytorium Dokumentów Finansowych oraz osobne pobieranie odpisów PDF, żeby odczytać nazwiska. Nasze API zastępuje te trzy procesy czterema zapytaniami GET z jednym kluczem.
Te same dane widać w aplikacji. Jeśli chcesz najpierw obejrzeć finanse konkretnej spółki, skorzystaj z wyszukiwarki sprawozdań finansowych spółek, a pełną dokumentację metod znajdziesz na stronie dokumentacji API.
GET /api/v1/spolki/{slug}
{
"dane": {
"nazwa": "<nazwa spolki>",
"krs": "<numer KRS>",
"nip": "<numer NIP>",
"forma": "<forma prawna>",
"status": "<status>",
"osoby": [
{ "rola": "<rola>", "udzial_procent": 0 }
],
"sprawozdania": [
{ "rok": 0, "przychody": 0,
"zysk_netto": 0, "kapital_wlasny": 0 }
]
}
}
Porównanie
Oficjalne API KRS, pliki z repozytorium czy API Przedsiębiorcy
Uczciwie: jeśli potrzebujesz wyłącznie aktualnego odpisu dla znanego numeru KRS, oficjalne API wystarczy i nic nie kosztuje. Płatne API ma sens, gdy w procesie liczą się finanse, wyszukiwanie po NIP i powiązania osób.
| Kryterium | Oficjalne API KRS | Repozytorium Dokumentów Finansowych | API Przedsiębiorcy |
|---|---|---|---|
| Klucz wyszukiwania | tylko numer KRS | numer KRS w formularzu | NIP, KRS albo nazwa |
| Liczby ze sprawozdań | nie, tylko wzmianka o złożeniu | tak, w pliku XML lub PDF do pobrania | przychody, zysk netto, kapitał własny z lat |
| Dane osób | zamaskowane gwiazdkami | nie dotyczy | role i udziały z profilem osoby |
| Inne spółki prezesa | nie | nie | tak, wszystkie role osoby z datami |
| Format | JSON z całym odpisem | pliki do samodzielnego parsowania | zwięzły JSON z gotowymi polami |
| Koszt | bezpłatne | bezpłatne, praca programisty | od 745 zł netto miesięcznie |
Źródła publiczne: Portal Rejestrów Sądowych oraz Repozytorium Dokumentów Finansowych.
Co zwraca API
Dane finansowe spółek i powiązania osób w jednym kluczu
Pola są nazwane po polsku i mają stały typ. Kwoty przychodu, zysku i kapitału przychodzą jako liczby całkowite w złotych albo jako null, gdy spółka danej pozycji nie wykazała, więc nie musisz rozpoznawać tekstu ani separatorów tysięcy.
01
Identyfikacja spółki
Nazwa, numer KRS, NIP, REGON, forma prawna, miasto, województwo i status w rejestrze.
02
Sprawozdania z kilku lat
Rok, przychody, zysk netto i kapitał własny jako liczby całkowite w złotych, gotowe do scoringu.
03
Zarząd i wspólnicy
Osoby z rolami w spółce i procentem udziałów, z adresem profilu każdej osoby.
04
Inne spółki osoby
Profil osoby zwraca wszystkie jej role w spółkach z datami od i do, także zakończone.
05
Szacunek wartości udziałów
Dolna i górna granica szacowanej wartości udziałów osoby wraz z datą danych.
06
Wyszukiwanie po NIP i nazwie
Parametr q przyjmuje nazwę, NIP albo numer KRS. Wyniki są posortowane po przychodzie.
Te same dane w aplikacji
Profil spółki, który API oddaje w JSON
Analityk widzi profil w przeglądarce, a system pobiera go przez API. Dzięki temu dział ryzyka i programiści pracują na tych samych liczbach, a decyzję z automatu łatwo sprawdzić ręcznie.
Jak zacząć
Pierwsze zapytanie w czterech krokach
1
Wybierz plan Firma
Zakładasz konto i płacisz kartą. Faktura VAT trafia na adres e-mail od razu po płatności.
2
Wygeneruj klucz
W panelu, w zakładce API, tworzysz klucz. Widzisz go w całości raz, a u nas zostaje tylko jego skrót.
3
Szukaj po NIP
GET /api/v1/spolki?q=NIP z nagłówkiem Authorization: Bearer zwraca spółkę ze slugiem.
4
Pobierz finanse
GET /api/v1/spolki/{slug} oddaje zarząd, wspólników i sprawozdania z kolejnych lat.
Dla kogo
Kto podłącza dane finansowe spółek przez API
API kupują zespoły, w których decyzja o kliencie albo dostawcy zapada w systemie, a nie w arkuszu. Każde ręczne pobranie sprawozdania to kilka minut pracy, a przy setkach wniosków miesięcznie to etat.
Leasing i faktoring
Przychód, wynik i kapitał własny z kilku lat zasilają model oceny wniosku, zanim analityk otworzy teczkę.
Fintech i płatności
Onboarding klienta biznesowego po NIP: status w rejestrze, zarząd i wspólnicy w jednym przebiegu.
CRM i sprzedaż B2B
Karty firm uzupełniają się o przychód i decydentów, a handlowiec widzi wielkość klienta przed telefonem.
Biura rachunkowe i doradcy
Porównanie klienta z firmami z branży i kontrola powiązań przed przyjęciem zlecenia.
Plan i cena
Ile kosztuje API z danymi finansowymi spółek
API jest w dwóch planach. Ceny netto przy płatności rocznej, kasa dolicza 23% VAT. Analityk bez API wystarczy, jeśli dane przeglądasz w aplikacji i eksportujesz do CSV lub XLSX.
Analityk
249 zł
netto / mies., miesięcznie 499 zł
- pełne finanse spółek w aplikacji
- eksport do 2 000 wierszy
- 100 obserwowanych osób i spółek
- bez API
Firma
745 zł
netto / mies., miesięcznie 1 490 zł
- API REST, 20 000 zapytań miesięcznie
- eksport 20 000 wierszy
- 1 000 obserwowanych osób i spółek
- 5 stanowisk
Instytucja
1 995 zł
netto / mies., miesięcznie 3 990 zł
- API REST, 200 000 zapytań miesięcznie
- 10 000 obserwowanych osób i spółek
- 3 000 raportów PDF miesięcznie
- 20 stanowisk
Gdy zamiast odpytywać rejestr chcesz pilnować zmian u stałych klientów, połącz API z listą obserwowanych opisaną na stronie monitoring kontrahentów w KRS.
Pytania
Pytania o API KRS i dane finansowe
Skąd pochodzą liczby i jak liczymy szacunek wartości udziałów, opisuje strona metodologii.
Czy API KRS zwraca sprawozdania finansowe?
Oficjalne API KRS Ministerstwa Sprawiedliwości nie zwraca liczb ze sprawozdań. W odpisie jest tylko wzmianka o złożeniu dokumentu, z datą i okresem, za który go złożono. Same pliki leżą w Repozytorium Dokumentów Finansowych, najczęściej jako XML do pobrania ręcznie. Nasze API zwraca przychody, zysk netto i kapitał własny z kolejnych lat w jednej odpowiedzi.
Czy API KRS jest darmowe?
Tak, oficjalne API KRS jest bezpłatne i nie wymaga klucza. Zwraca odpis aktualny albo pełny w formacie JSON dla podanego numeru KRS. Płacisz dopiero wtedy, gdy potrzebujesz czegoś, czego to API nie daje: wyszukiwania po NIP lub nazwie, pełnych danych osób, liczb finansowych albo powiązań osoby z innymi spółkami.
Jak pobrać dane z KRS po NIP?
Oficjalne API KRS przyjmuje wyłącznie numer KRS, więc NIP trzeba najpierw zamienić na KRS w innym źródle. W naszym API wysyłasz NIP w parametrze q zapytania GET /api/v1/spolki i dostajesz spółkę z numerem KRS, REGON, formą prawną i siedzibą. Kolejne zapytanie o slug zwraca zarząd, wspólników i finanse.
Dlaczego w API KRS nazwiska są ukryte gwiazdkami?
Odpowiedź oficjalnego API KRS maskuje dane osób: zamiast nazwiska członka zarządu widać pierwszą literę i gwiazdki, a PESEL też jest ukryty. Pełne imiona i nazwiska są w odpisie PDF z wyszukiwarki KRS. Nasze API zwraca role osób w spółce razem z ich profilem, z wyjątkiem osób, które złożyły sprzeciw.
Ile kosztuje API z danymi finansowymi spółek?
Dostęp do API jest w planie Firma za 745 zł netto miesięcznie przy płatności rocznej (1 490 zł przy płatności miesięcznej) i obejmuje 20 000 zapytań w miesiącu. Plan Instytucja za 1 995 zł netto daje 200 000 zapytań. Do cen doliczamy 23% VAT, a fakturę dostajesz od razu po płatności.
Jaki jest limit zapytań do API?
Każde zapytanie zużywa jedno z miesięcznej puli planu: 20 000 w planie Firma i 200 000 w planie Instytucja. Stan limitu podajemy w nagłówkach każdej odpowiedzi (X-Limit-Miesiac i X-Limit-Zostalo), a po wyczerpaniu puli API odpowiada kodem 429 do początku kolejnego miesiąca.
Podłącz finanse spółek do swojego systemu
Załóż konto, wybierz plan Firma i wygeneruj klucz w panelu. Pierwsze zapytanie po NIP wyślesz kilka minut po płatności.