API wykazu podatników VAT · dla księgowości i IT
API białej listy: limity, metody i automatyzacja
Z tego samego API Ministerstwa Finansów korzysta narzędzie powyżej – możesz go użyć bez programowania. Poniżej opisujemy, jak API działa, ile zapytań przyjmuje i jak wbudować weryfikację kontrahentów w program ERP.
Sygnały ostrzegawcze
Sprawozdanie finansowe z KRS
- Otwórz Przeglądarkę Dokumentów Finansowych (otworzy się w nowej karcie) i wpisz numer KRS firmy.
- Przy „Roczne sprawozdanie finansowe” rozwiń szczegóły i kliknij „Pobierz dokumenty”. Możesz pobrać kilka lat.
- Wczytaj pobrane pliki ZIP albo XML tutaj – odczytamy je w Twojej przeglądarce.
Gdzie sprawdzić więcej
Rejestry dłużników KRD, BIG InfoMonitor i ERIF są płatne i wymagają umowy z biurem informacji gospodarczej – nie da się ich sprawdzić bezpłatnie. Długi wobec urzędów skarbowych i samorządów od 5000 zł pokazuje bezpłatnie Rejestr Należności Publicznoprawnych – po zalogowaniu w e-Urzędzie Skarbowym.
Weryfikacja kontrahentów Enology · enology.pl
Wynik ma charakter informacyjny i nie zastępuje porady doradcy podatkowego ani oceny kredytowej. Dowodem sprawdzenia przed urzędem jest identyfikator zapytania z wykazu MF, nie ten wydruk – zachowaj go z dokumentami płatności. Próg 15 000 zł i termin ZAW-NR (7 dni) według stanu prawnego na dziś. Regulamin · Jak sprawdzamy
Wyślij wynik na e-mail
Dostaniesz podsumowanie: ile sygnałów ostrzegawczych albo pozycji wymaga uwagi i co zrobić dalej. Bez numerów, nazw i kwot – pełny raport zostaje w Twoim pliku Excel i na wydruku.
Metody i limity
| Metoda | Co robi | Limit |
|---|---|---|
/api/search/nips/{nipy} | pełne dane do 30 podmiotów na wskazany dzień (do 5 lat wstecz) | 100 zapytań dziennie z adresu IP |
/api/check/nip/{nip}/bank-account/{nrb} | TAK albo NIE: czy rachunek jest przypisany do czynnego podatnika (także rachunek wirtualny) | |
WL2 /api2/status/nip/ (od 12.10.2026) | tylko status VAT pojedynczego NIP-u | 50 000 zapytań dziennie |
| Plik płaski | codzienna lista skrótów rachunków czynnych i zwolnionych podatników do sprawdzania u siebie | bez zapytań do API |
Najważniejsze kody błędów: WL-191 – limit zapytań na dziś wyczerpany (HTTP 429), WL-195 – baza właśnie się zaktualizowała, ponów zapytanie, WL-196 – trwa aktualizacja bazy, WL-103 – data z przyszłości.
Przykład zapytania
GET https://wl-api.mf.gov.pl/api/search/nips/5260250274,7740001454?date=2026-10-10
{"result":{"entries":[{"identifier":"5260250274","subjects":[{"name":"MINISTERSTWO FINANSÓW",
"statusVat":"Czynny","accountNumbers":["09101010100075912223000000", …],"hasVirtualAccounts":true}]}, …],
"requestId":"Q66nK-9903ani","requestDateTime":"10-10-2026 15:16:42"}}requestId to identyfikator zapytania. Według opisu API MF „może także potwierdzać fakt dokonania tego zapytania przed organami podatkowymi”. Jedno zapytanie o 30 NIP-ów ma jeden identyfikator – zapisuj go przy każdym kontrahencie z paczki, razem z datą odpowiedzi.
Weryfikacja kontrahentów w programie ERP
- Comarch ERP Optima – seryjne „Zweryfikuj status VAT i rachunki bankowe” dla zaznaczonych kontrahentów, historia weryfikacji na karcie kontrahenta (w programach na gwarancji).
- enova365 – weryfikacja kontrahenta w białej liście, VIES i REGON prosto z kartoteki, biała lista i podzielona płatność przy przelewach.
- Automatyzacje na zamówienie – sprawdzanie rachunków przed wysłaniem paczki przelewów, plik płaski dla tysięcy płatności, raporty dla biura rachunkowego z wieloma firmami.
- Asystent AI z danymi enova365 (MCP) – nasze rozwiązanie wdrożeniowe, a nie produkt producenta enova365: asystent korzysta z danych enova365, na które pozwolisz, np. o kontrahentach i płatnościach.
Szczegóły: integracje i rozwiązania na zamówienie.
Dla firm
Weryfikacja kontrahentów w Twoim programie
Comarch ERP Optima sprawdza status VAT i rachunki seryjnie dla zaznaczonych kontrahentów i zapisuje historię weryfikacji, a enova365 weryfikuje kontrahenta w białej liście, VIES i REGON prosto z kartoteki. Ustawimy to w Twoim programie, przeniesiemy dane z obecnego systemu albo zautomatyzujemy weryfikację integracją – także dla biura rachunkowego z wieloma firmami.
Najczęstsze pytania
Jaki jest limit API białej listy?
100 zapytań dziennie z jednego adresu IP, w każdym do 30 podmiotów (gov.pl, stan na 10.10.2026). Po przekroczeniu MF może zablokować dostęp do północy – także do wyszukiwarki na stronie MF. Usługa WL2, uruchamiana 12 października 2026 r., ma limit 50 000 zapytań dziennie, ale zwraca tylko status VAT, bez rachunków.
Czy API białej listy wymaga klucza albo rejestracji?
Nie. Według opisu API MF nie jest wymagane uwierzytelnianie. Wystarczy zapytanie HTTPS z NIP-em (albo listą NIP-ów) i datą.
Co zwraca API?
Status VAT, nazwę, NIP, REGON, KRS, adresy, daty rejestracji, wykreślenia i przywrócenia z podstawą prawną, listę rachunków, informację o rachunkach wirtualnych oraz identyfikator zapytania (requestId) i czas odpowiedzi.
Jak sprawdzić tysiące rachunków dziennie?
Do masowej weryfikacji rachunków MF udostępnia plik płaski – codziennie aktualizowaną listę skrótów rachunków, którą program sprawdza u siebie, bez limitu zapytań. Plik nie zawiera statusu VAT, więc w praktyce łączy się go z API. Takie rozwiązania budujemy w integracjach z programami ERP.
Czy enova365 i Comarch ERP Optima korzystają z API białej listy?
Tak. Comarch ERP Optima sprawdza status VAT i rachunki seryjnie dla zaznaczonych kontrahentów (w programach na gwarancji) i zapisuje historię weryfikacji, a enova365 weryfikuje kontrahenta w białej liście, VIES i REGON z kartoteki. Pomożemy to ustawić i zautomatyzować resztę procesu.
Inne kalkulatory
- Kalkulator kosztu wdrożenia ERPIle kosztuje wdrożenie i licencja Comarch ERP Optima albo enova365 w twojej firmie i ile potrwa.
- Sprawozdanie finansowe z KRS: kondycja firmyWczytaj sprawozdanie z KRS: przychody, zysk, zadłużenie i płynność na wykresach, model poznański.
- Biała lista VAT: rachunek i próg 15 000 złKiedy trzeba sprawdzić rachunek, co grozi za przelew poza listę i jak złożyć ZAW-NR.
- VIES: sprawdzanie kontrahenta z UENumer VAT UE, numer konsultacji i stawka 0% przy dostawie wewnątrzwspólnotowej.
- Kalkulator wynagrodzeńBrutto, netto i koszt firmy: umowa o pracę, zlecenie, dzieło i B2B.
- Kalkulator formy opodatkowaniaSkala, liniowy czy ryczałt – która forma da najniższe podatki i składki.
- Kalkulator leasinguIle leasing kosztuje po podatkach i jak rozłożyć koszty na lata: wpłata, okres, wykup, limity aut.
- Kalkulator biura rachunkowegoDla biur rachunkowych: wycena klienta z ofertą PDF, rentowność klientów z pliku CSV i czas oszczędzony dzięki automatyzacji.
- Kalkulator estońskiego CITCzy ryczałt od dochodów spółek się opłaca: test warunków i porównanie z CIT 9%/19% na 1–4 lata.
- Test NIS2 i KSCCzy firma podlega ustawie o KSC (NIS2): podmiot kluczowy czy ważny, terminy, kary i samoocena gotowości.
- Kalkulator luki płacowejLuka płacowa z pliku listy płac (liczona tylko w przeglądarce): średnia, mediana, kwartyle, kategorie z luką 5%.
- Test: od kiedy KSeF mnie dotyczyTwoje terminy w KSeF, wyjątki do końca 2026 r. i co zrobić przed 1 stycznia 2027 r. Do tego kalkulator kar i podgląd faktury XML.
- Kalkulator podstawy chorobowegoPodstawa wynagrodzenia chorobowego i zasiłku z 12 miesięcy: pracownik, zleceniobiorca i przedsiębiorca, także zasiłek opiekuńczy i po ustaniu ubezpieczenia.
Kalkulator przygotował zespół Enology. Korzystanie z niego jest bezpłatne i nie wymaga rejestracji – zasady opisuje regulamin, a sposób liczenia strona Jak liczymy. Wynik ma charakter informacyjny i nie zastępuje porady doradcy podatkowego. Dowodem sprawdzenia jest identyfikator zapytania z wykazu MF. Kalkulator się przydał? Oceń nas w Google.