Biała lista API limit zapytań i nowy adres API wykazu podatników VAT

API białej listy ma dwa limity. Metoda search przyjmuje 100 zapytań dziennie, każde o najwyżej 30 podmiotów, czyli do 3 000 firm na dobę. Metoda check, która odpowiada tylko TAK albo NIE dla pary NIP i rachunek, ma limit 5 000 podmiotów. Po wyczerpaniu limitu Ministerstwo Finansów może zablokować dostęp do północy. Od 15 października 2026 r. API ma nowy adres, a stary wl-api.mf.gov.pl działa do 1 grudnia 2026 r.

Ten tekst jest dla zespołu, który ma już własną integrację z wykazem podatników VAT albo właśnie ją planuje: dla działu finansów, który sprawdza kilkuset dostawców przed każdym przebiegiem płatności, dla biura rachunkowego z listą kontrahentów wielu klientów i dla software house'u, który dopisuje weryfikację NIP do ERP. Rozpisujemy, ile naprawdę mieści się w darmowych limitach, co zmienia przeprowadzka API na nowy adres i kiedy taniej jest kupić gotowe sprawdzenia, niż utrzymywać własny kod.

Biała lista API limit dla metod search, check i WL2

Ministerstwo Finansów udostępnia dziś trzy sposoby odpytywania wykazu przez API. Różnią się tym, co zwracają, i limitem. Liczby poniżej pochodzą z opisu API na stronie Krajowej Administracji Skarbowej w dniu pisania tego tekstu, a opis API ma wersję 1.6.1 z 12 października 2026 r.

Po wyczerpaniu jednego z limitów dostęp do API może zostać zablokowany do godziny 0:00, i to razem z wyszukiwarką na stronie wykazu. MF zaznacza, że blokada jest fakultatywna, więc nie zawsze nastąpi, ale nie da się na tym budować procesu płatności. Zbyt szybkie odpytywanie może też zatrzymać zabezpieczenie po stronie serwera, nawet gdy dzienny limit jest daleko.

Ile kontrahentów sprawdzisz w darmowym limicie

Na papierze 3 000 podmiotów dziennie z metody search wystarczy prawie każdej firmie. W praktyce limit kończy się szybciej z trzech powodów.

• Każde zapytanie o jedną firmę zużywa całe zapytanie. 30 podmiotów mieści się w jednym wywołaniu tylko wtedy, gdy integracja zbiera NIP-y w paczki. Formularz w ERP, który sprawdza kontrahenta przy zapisie faktury, wysyła zwykle jedno zapytanie na jeden NIP. Wtedy limit to 100 firm dziennie.
• Ten sam limit dzieli kilka systemów. Jeśli ERP, program do faktur i skrypt działu płatności wychodzą do sieci przez jeden adres firmy, zużywają wspólną pulę. Pierwszy, kto ją wyczerpie, blokuje resztę do północy.
• Sprawdzasz w dniu zapłaty, a nie w dniu faktury. Rozsądny proces sprawdza kontrahenta przy fakturze i drugi raz w dniu przelewu, bo status i rachunki zmieniają się między tymi datami. To podwaja zużycie.

Przykład z życia: biuro rachunkowe z 60 klientami, z których każdy ma średnio 40 aktywnych dostawców, ma 2 400 par NIP i rachunek do sprawdzenia przed każdym cyklem płatności. Metoda check to udźwignie, ale nie da pełnego rekordu z nazwą i statusem. Metoda search w paczkach po 30 zmieści to w 80 zapytaniach, czyli prawie w całym dziennym limicie, i nie zostawi miejsca na nowe faktury.

Nowy adres API białej listy od 15 października 2026

Od 15 października 2026 r. API wykazu ma nowe adresy: produkcyjny wykazpodatnikowvat.mf.gov.pl/api/ dla metod search i check oraz wykazpodatnikowvat.mf.gov.pl/api2 dla WL2. Środowisko testowe przeniesiono na wykazpodatnikowvat-test.mf.gov.pl. Dotychczasowy adres wl-api.mf.gov.pl działa do 1 grudnia 2026 r.

Dla każdej integracji to konkretna praca z terminem. Trzeba zmienić adres w konfiguracji, przetestować odpowiedzi na środowisku testowym, sprawdzić reguły zapory, jeśli firma wpuszcza ruch wychodzący tylko do znanych domen, i wdrożyć zmianę przed grudniem. W dniu pisania tego tekstu stary adres zwracał normalne dane w JSON, a zapytanie o NIP pod nowym adresem produkcyjnym odpowiadało jeszcze stroną internetową, więc warto przełączać się dopiero po własnym teście, a nie w ostatnim tygodniu listopada.

Firma, która korzysta z gotowego narzędzia, nie robi nic: przeprowadzkę adresu obsługuje dostawca. Przy zamówieniu warto o to zapytać wprost, bo po 1 grudnia integracja, której nikt nie przestawił, przestanie zwracać dane bez żadnego komunikatu dla księgowości.

Co zrobić, gdy limit API białej listy nie wystarcza

Są cztery drogi i każda ma swoją cenę. Wybór zależy od tego, czy potrzebujesz pełnego rekordu, czy tylko potwierdzenia rachunku, i od tego, ile czasu programisty masz na utrzymanie.

Plik płaski rozpisaliśmy osobno we wpisie plik płaski biała lista: działa bez limitu, ale potwierdza tylko rachunek, a dowodem jest wtedy Twój własny zapis porównania. Pełny koszt utrzymania własnej integracji z czterema rejestrami, od protokołów po dyżur, liczymy we wpisie CEIDG API i koszt własnej integracji.

Sprawdzanie setek kontrahentów bez pilnowania limitu MF

W Businesses sprawdzenie liczy się z limitu Twojego poziomu, a nie z dziennej puli adresu Twojej firmy w MF. Na poziomie Biuro (399 zł netto miesięcznie) masz 2 000 sprawdzeń, import listy NIP-ów z pliku CSV, monitoring 500 firm z alertem przy zmianie statusu VAT, rachunków albo zarządu oraz archiwum z eksportem. Na poziomie Firma (999 zł netto) jest 10 000 sprawdzeń, monitoring 5 000 firm, API z kartą firmy pod jednym adresem i webhooki.

Jedno zapytanie po NIP, REGON albo numer KRS zwraca od razu status VAT i rachunki z wykazu, odpis KRS albo wpis CEIDG i identyfikator zapytania z MF, który trafia do PDF. Nie składasz rekordu z trzech rejestrów i nie pilnujesz, czy paczka zmieści się w 30 podmiotach. Jak wygląda odpowiedź i jak działa klucz, opisuje strona KRS API, REGON API i API białej listy VAT. Gdy integracja nie jest potrzebna, a chodzi o stałą listę dostawców, wystarczy monitoring kontrahentów z importem z pliku.

Biura rachunkowe zwykle łączą to z resztą codziennej pracy: faktury kosztowe wpadają do programu dla biura rachunkowego, który sam czyta faktury z KSeF, a sprawdzenie kontrahenta i rachunku idzie obok, w dniu przygotowania przelewów.

Najczęstsze pytania o API białej listy

Ile zapytań można wysłać do API białej listy?

Metodą search 100 zapytań dziennie, każde o najwyżej 30 podmiotów, czyli do 3 000 firm na dobę. Metoda check, która odpowiada TAK albo NIE dla pary NIP i rachunek, ma limit 5 000 podmiotów. Nowa usługa WL2 zwracająca sam status VAT przyjmuje 50 000 zapytań na dzień.

Co się dzieje po przekroczeniu limitu API białej listy?

Ministerstwo Finansów może zablokować dostęp do API do godziny 0:00, razem z metodami search i check oraz wyszukiwarką na stronie wykazu. Blokada jest fakultatywna, więc nie musi nastąpić, ale przez resztę dnia integracja może nie zwracać danych, a przelewy czekają na ręczne sprawdzenie.

Czy API białej listy jest płatne?

Nie. API wykazu podatników VAT jest bezpłatne i nie wymaga klucza ani rejestracji. Płacisz za to czasem programisty: za zbudowanie paczkowania zapytań, obsługę blokady, zapis identyfikatorów zapytań jako dowodu i teraz za przeniesienie integracji na nowy adres przed 1 grudnia 2026 r.

Jaki jest nowy adres API białej listy?

Od 15 października 2026 r. produkcyjne API metod search i check działa pod adresem wykazpodatnikowvat.mf.gov.pl/api/, a usługa WL2 pod wykazpodatnikowvat.mf.gov.pl/api2. Środowisko testowe jest pod wykazpodatnikowvat-test.mf.gov.pl. Stary adres wl-api.mf.gov.pl działa do 1 grudnia 2026 r.

Czy odpowiedź z API białej listy jest dowodem sprawdzenia kontrahenta?

Tak, jeśli zapiszesz identyfikator zapytania, który MF zwraca przy każdej odpowiedzi metod search i check. Ten unikalny klucz pozwala potwierdzić, że w danym dniu sprawdziłeś konkretny rachunek. Bez zapisanego identyfikatora zostaje Ci tylko twierdzenie, że sprawdzenie się odbyło.

Jeżeli Twoja integracja dobija do limitu albo czeka ją przeprowadzka na nowy adres, sprawdź najpierw jedną firmę w polu powyżej. Zobaczysz nazwę, status VAT, REGON, numer KRS i liczbę rachunków z wykazu, bez liczenia zapytań w MF, a w koncie dostaniesz do tego PDF z identyfikatorem zapytania.