Nowy adres API Białej listy VAT i metoda WL2: co zmienić do 1 grudnia 2026

Co się zmieniło 15 października 2026

Ministerstwo Finansów przeniosło API Wykazu podatników VAT, czyli Białej listy, na nowy adres. Stary adres na razie przekierowuje na nowy, ale według komunikatu MF działa tylko do 1 grudnia 2026 roku. Razem z adresem zmienił się certyfikat bezpieczeństwa serwisu.

Usługa	Do 15.10.2026	Od 15.10.2026
API, produkcja	wl-api.mf.gov.pl	wykazpodatnikowvat.mf.gov.pl/api/
API, test	wl-test.mf.gov.pl	wykazpodatnikowvat-test.mf.gov.pl/api/
API WL2, produkcja	brak	wykazpodatnikowvat.mf.gov.pl/api2
API WL2, test	brak	wykazpodatnikowvat-test.mf.gov.pl/api2

Ścieżki metod się nie zmieniły: /api/search/nip/{nip} i /api/check/nip/{nip}/bank-account/{rachunek} działają tak samo, tylko pod nowym hostem. Aktualna dokumentacja to wersja API 1.6.1 z 12 października 2026 (Swagger, opis PDF, plik kodów błędów i dane testowe) na stronie API Wykazu podatników VAT.

Trzy metody, trzy różne limity

Metoda	Podajesz	Dostajesz	Limit według MF
search	NIP, REGON albo rachunek, plus datę	pełne dane z wykazu: nazwa, adresy, status VAT, rachunki, daty rejestracji i wykreślenia	100 zapytań dziennie, do 30 podmiotów w jednym zapytaniu
check	NIP albo REGON, rachunek i datę	TAK albo NIE: czy rachunek jest przypisany do podmiotu w tym dniu	„5000 podmiotów”
WL2	NIP i opcjonalnie datę	status VAT: Czynny, Zwolniony albo Niezarejestrowany	50 000 zapytań dziennie

Każda odpowiedź zawiera identyfikator zapytania (requestId), który potwierdza, że weryfikacja została wykonana, wraz z datą zapytania i datą, której dotyczy odpowiedź. Warto go zapisywać przy kontrahencie albo płatności.

Dwie rzeczy, których strona MF nie precyzuje. Przy metodzie check pisze o 5000 podmiotów, bez dopisku „dziennie”. A blokada po przekroczeniu limitu jest opisana dla search, check i wyszukiwarki na stronie wykazu, bez wzmianki o WL2. Bezpieczniej traktować oba limity jako dzienne i nie zakładać, że WL2 przeżyje blokadę pozostałych metod.

Co się dzieje po przekroczeniu limitu

MF uprzedza, że po wyczerpaniu limitu dostęp może zostać zablokowany do 0:00, i to nie tylko do API: blokada obejmuje metody search i check oraz wyszukiwarkę na stronie wykazu. Limit liczy się dla adresu, z którego idą zapytania, więc jedna aplikacja, która wyczerpie pulę, odcina wszystkie inne usługi na tym samym serwerze. Szczegółów zabezpieczeń Ministerstwo nie publikuje.

W praktyce 100 wywołań search to mało. Wyszukiwarka na stronie, autouzupełnianie w CRM i nocna weryfikacja kontrahentów potrafią zjeść je przed południem, jeśli każda z nich pyta osobno.

Jak rozłożyć zapytania po zmianach

WL2 zmienia rachunek, bo najczęstsze pytanie, czyli „czy firma nadal jest czynnym podatnikiem VAT”, nie musi już kosztować zapytania search. Tak to rozkładam w swoich integracjach:

1. Status VAT przez WL2. Codzienna weryfikacja wszystkich kontrahentów mieści się w limicie 50 000 z dużym zapasem.
2. Znane rachunki przez check. Jeśli rachunek kontrahenta jest już zapisany, check odpowiada, czy nadal jest na liście. Nie trzeba pobierać całego wpisu.
3. Search tylko wtedy, gdy trzeba. Dla nowej firmy, przy zmianie statusu albo gdy check zwróci NIE, bo dopiero wtedy potrzebna jest aktualna lista rachunków.
4. Osobne pule dla osobnych zadań. Wyszukiwarka dla użytkowników nie może zjeść limitu nocnej weryfikacji i odwrotnie. Licznik dzienny według czasu warszawskiego, a gdy search się wyczerpie, użytkownik i tak dostaje status VAT z WL2, z informacją, że rachunków chwilowo brak.
5. Plik płaski przy dużej skali. MF publikuje go codziennie o północy na wykazpodatnikowvat.mf.gov.pl/plik-plaski. Pary NIP i rachunek są zahaszowane, więc da się sprawdzić tylko parę, którą już znasz, za to bez limitów.

Tak od 25 października działa wyszukiwarka firm po NIP na tej stronie oraz aplikacja „Dane z GUS i Biała lista VAT” dla Pipedrive: status VAT z WL2, rachunki z check, search tylko dla nowych firm i po zmianach.

Checklist migracji do 1 grudnia 2026

• Wyszukaj w kodzie i konfiguracji wl-api.mf.gov.pl i wl-test.mf.gov.pl, także w zmiennych środowiskowych, regułach firewalla i listach dozwolonych adresów.
• Jeśli aplikacja przypina certyfikat albo działa na starym środowisku (stara Java, własny truststore), sprawdź połączenie z nowym hostem przed 1 grudnia, bo certyfikat się zmienił.
• Przetestuj na wykazpodatnikowvat-test.mf.gov.pl z danymi testowymi z dokumentacji, nie na prawdziwych NIP-ach klientów.
• Przenieś sprawdzanie samego statusu VAT na WL2, a znanych rachunków na check. Search zostaw dla nowych firm.
• Zapisuj requestId i datę odpowiedzi przy kontrahencie albo płatności.
• Obsłuż odpowiedź o wyczerpanym limicie tak, żeby użytkownik dostał komunikat, a nie pusty wynik. Plik kodów błędów jest w dokumentacji MF.
• Jeśli korzystasz z gotowej wtyczki albo programu do faktur, zapytaj dostawcę o datę przejścia na nowy adres.

Gotowe narzędzie czy własna integracja

Pojedynczą firmę sprawdzisz ręcznie w wyszukiwarce po NIP: status VAT, rachunki, dane z REGON i KRS, bez logowania. Jeśli dane mają same trafiać do CRM, a kontrahenci mają być sprawdzani co noc, zobacz integracje Pipedrive z GUS i KRS i HubSpot z GUS, KRS i CEIDG. Jak działa samo API REGON, opisuję w poradniku Dane firmy z GUS po NIP.