Krótka odpowiedź
API KRS Ministerstwa Sprawiedliwości jest bezpłatne, ale wyszukuje wyłącznie po numerze KRS. Żeby dojść do spółki po NIP, trzeba najpierw zamienić NIP na KRS w innym rejestrze, na przykład w API wykazu podatników VAT albo w usłudze BIR GUS. Liczby ze sprawozdań leżą osobno w Repozytorium Dokumentów Finansowych. Płatna alternatywa, taka jak API KRS ze sprawozdaniami finansowymi, przyjmuje NIP i od razu zwraca finanse, zarząd i wspólników.
Czego brakuje w oficjalnym API KRS
Usługa pod adresem api-krs.ms.gov.pl zwraca odpis aktualny albo pełny w formacie JSON. Nie wymaga klucza ani rejestracji, więc dla programisty, który zna numer KRS, to wygodny start. Problemy pojawiają się wtedy, gdy API ma obsłużyć prawdziwy proces biznesowy, w którym klient przychodzi z NIP-em z faktury albo z formularza.
- Jedyny klucz to numer KRS. Nie ma metody wyszukiwania po NIP, REGON ani nazwie. Zapytanie o nieistniejący numer kończy się kodem 404, a wyszukiwania po NIP API po prostu nie obsługuje.
- Zamaskowane osoby. W odpowiedzi członek zarządu wygląda jak „B*****” z imieniem „A***” i ukrytym numerem PESEL. Funkcję w organie widać, osoby już nie.
- Brak liczb finansowych. Dział 3 odpisu zawiera tylko wzmianki o złożeniu rocznego sprawozdania: datę złożenia i okres. Przychód, wynik i kapitał trzeba pobrać z innego systemu.
- Brak powiązań. Nie zapytasz, w jakich jeszcze spółkach zasiada prezes. Dane osób są zamaskowane, więc nie złożysz tego nawet samodzielnie.
Do sprawdzenia statusu znanej spółki i jej sposobu reprezentacji to API wystarczy. Do scoringu wniosku leasingowego, onboardingu klienta w fintechu albo uzupełniania kart w CRM już nie.
Jak pobrać dane z KRS po NIP bez płatnego API
Darmowe obejście istnieje i warto je znać, zanim zapłacisz za cokolwiek. Składa się z trzech kroków, każdy w innym systemie państwowym.
- NIP na numer KRS. API wykazu podatników VAT Ministerstwa Finansów (wl-api.mf.gov.pl) w metodzie search zwraca dla NIP-u nazwę, REGON, status VAT i numer KRS. Limit to 100 zapytań dziennie, po najwyżej 30 podmiotów w jednym zapytaniu. Spółek spoza rejestru VAT tam nie znajdziesz. Drugą drogą jest usługa BIR GUS, ale wymaga klucza wydawanego przez GUS i obsługi protokołu SOAP.
- Numer KRS na odpis. Z numerem KRS pytasz API KRS o odpis aktualny i odczytujesz zarząd, sposób reprezentacji, kapitał i PKD, pamiętając o zamaskowanych osobach.
- Sprawozdanie finansowe. Wchodzisz do Repozytorium Dokumentów Finansowych, wyszukujesz spółkę po numerze KRS i pobierasz plik sprawozdania, najczęściej XML w strukturze e-sprawozdań. Potem parsujesz bilans i rachunek zysków i strat, które różnią się wariantem zależnie od wielkości spółki.
Ten łańcuch działa, ale ma koszt, którego nie widać w cenniku. Trzeba utrzymywać trzy integracje, obsługiwać trzy rodzaje błędów i pilnować limitu wykazu VAT. Przekroczenie limitu blokuje dostęp do obu metod API wykazu do północy. Do tego dochodzi parser plików XML, który psuje się przy każdej zmianie struktury sprawozdań.
Porównanie dróg do danych spółki po NIP
| Droga | Co daje | Ograniczenia | Koszt |
|---|---|---|---|
| API KRS | odpis JSON, zarząd bez nazwisk, kapitał, PKD | tylko po numerze KRS, brak finansów | bezpłatne |
| API wykazu podatników VAT | NIP na KRS, status VAT, rachunki | 100 zapytań dziennie po 30 podmiotów, tylko podatnicy VAT | bezpłatne |
| BIR GUS | dane z REGON po NIP | klucz z GUS, protokół SOAP, brak finansów | bezpłatne |
| Repozytorium Dokumentów Finansowych | pliki sprawozdań | pobieranie po numerze KRS, parsowanie XML po Twojej stronie | bezpłatne, czas programisty |
| API Przedsiębiorcy | NIP, KRS lub nazwa w jednym parametrze, finanse z lat, zarząd, wspólnicy, inne spółki osób | miesięczna pula zapytań planu | od 745 zł netto miesięcznie |
Jeśli sprawdzasz kilka spółek w tygodniu, darmowe źródła wystarczą i nie ma sensu płacić. Jeśli w Twoim systemie co miesiąc przechodzą setki wniosków, a decyzja zależy od przychodu i kapitału własnego, darmowa droga zaczyna kosztować więcej niż abonament.
Ile kosztuje utrzymanie własnej integracji
Policz to na swoich stawkach. Pierwsza wersja łańcucha z trzema źródłami i parserem sprawozdań to zwykle kilka tygodni pracy programisty. Potem dochodzi utrzymanie: obsługa zmian w strukturze plików, ponawianie zapytań po błędach serwerów, kontrola limitu wykazu VAT i odpowiedzi na pytania działu ryzyka, czemu przy danej spółce brakuje liczb. Nawet przy kilku godzinach miesięcznie koszt utrzymania szybko zbliża się do ceny planu z API.
Jest też koszt, którego nie policzysz w godzinach. Gdy własny parser po cichu przestanie czytać jeden wariant rachunku zysków i strat, model scoringowy dostaje puste pola i nikt tego nie zauważa przez kilka tygodni.
Co zwraca API z danymi finansowymi spółek
Nasze API REST ma cztery metody GET. Lista spółek przyjmuje w parametrze q nazwę, NIP albo numer KRS i zwraca identyfikatory, formę prawną, siedzibę i status. Profil spółki dodaje osoby z rolami i procentem udziałów oraz sprawozdania z kolejnych lat: rok, przychody, zysk netto i kapitał własny jako liczby całkowite. Profil osoby zwraca wszystkie jej role w spółkach z datami od i do oraz szacowany przedział wartości udziałów.
Klucz wysyłasz w nagłówku Authorization w schemacie Bearer. Stan miesięcznego limitu widać w nagłówkach odpowiedzi, a po jego wyczerpaniu API zwraca kod 429. Pełne przykłady zapytań i odpowiedzi są w dokumentacji API. Osoby, które złożyły sprzeciw wobec publikacji profilu, nie są zwracane.
Czy API KRS jest darmowe?
Tak, oficjalne API KRS jest bezpłatne i działa bez klucza. Płacić warto dopiero wtedy, gdy potrzebujesz czegoś, czego to API nie zwraca: wyszukiwania po NIP lub nazwie, liczb ze sprawozdań, pełnych danych osób albo ich powiązań z innymi spółkami. Sam odpis dla znanego numeru KRS zawsze pobierzesz za darmo.
Czy API KRS zwraca sprawozdania finansowe?
Nie. Odpis z API KRS zawiera tylko wzmianki o złożeniu sprawozdania, czyli datę złożenia i okres, którego dotyczy. Same liczby trzeba pobrać z Repozytorium Dokumentów Finansowych jako plik i przetworzyć samodzielnie. API ze sprawozdaniami zwraca przychody, zysk netto i kapitał własny z kolejnych lat w jednej odpowiedzi JSON.
Jak sprawdzić KRS po NIP w API?
W oficjalnym API KRS się nie da, bo przyjmuje wyłącznie numer KRS. Numer KRS dla NIP-u podaje metoda search API wykazu podatników VAT, w limicie 100 zapytań dziennie. W naszym API wysyłasz NIP w parametrze q metody GET /api/v1/spolki i dostajesz spółkę z numerem KRS, a następne zapytanie zwraca jej zarząd i finanse.
Dla kogo płatna alternatywa ma sens
Najczęściej kupują ją firmy leasingowe i faktoringowe, które oceniają wnioski po wynikach spółki, fintechy z onboardingiem klientów biznesowych, zespoły sprzedaży B2B uzupełniające CRM o przychód i decydentów oraz biura rachunkowe sprawdzające klienta przed przyjęciem zlecenia. Wspólny mianownik to powtarzalny proces, w którym ręczne pobieranie sprawozdań zajmuje czas analityka.
Jeśli zamiast odpytywać rejestr przy każdym wniosku chcesz pilnować zmian u stałych klientów, połącz API z listą obserwowanych opisaną na stronie monitoring kontrahentów w KRS. A gdy dane potrzebne są analitykowi, a nie systemowi, wystarczy wyszukiwarka sprawozdań finansowych w planie Analityk.
Podsumowanie wyboru
Znasz numer KRS i potrzebujesz tylko odpisu: zostań przy bezpłatnym API KRS. Masz NIP, kilka spółek tygodniowo i czas programisty: złóż łańcuch z wykazu VAT, API KRS i repozytorium. Masz setki spółek miesięcznie, a decyzja zależy od przychodu, kapitału i ludzi w zarządzie: wybierz API KRS ze sprawozdaniami finansowymi w planie Firma za 745 zł netto miesięcznie i wyślij pierwsze zapytanie kilka minut po płatności.