Przejdź do treści

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.

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.

KryteriumOficjalne API KRSRepozytorium Dokumentów FinansowychAPI Przedsiębiorcy
Klucz wyszukiwaniatylko numer KRSnumer KRS w formularzuNIP, KRS albo nazwa
Liczby ze sprawozdańnie, tylko wzmianka o złożeniutak, w pliku XML lub PDF do pobraniaprzychody, zysk netto, kapitał własny z lat
Dane osóbzamaskowane gwiazdkaminie dotyczyrole i udziały z profilem osoby
Inne spółki prezesanienietak, wszystkie role osoby z datami
FormatJSON z całym odpisempliki do samodzielnego parsowaniazwięzły JSON z gotowymi polami
Kosztbezpłatnebezpłatne, praca programistyod 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. 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. 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. 3

    Szukaj po NIP

    GET /api/v1/spolki?q=NIP z nagłówkiem Authorization: Bearer zwraca spółkę ze slugiem.

  4. 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
Wybierz plan Analityk

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
Kup plan Firma z API

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
Wybierz plan Instytucja

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.