Rejestry API → API białej listy VAT

API białej listy VAT

Status podatnika

GET /v1/vat/{nip}
Parametr Gdzie Opis
nip ścieżka NIP podatnika (10 cyfr, separatory dozwolone).
date query Dzień, na który sprawdzamy status. Domyślnie dziś.
fresh, certificate query Jak wyżej.

data: statusVat (Czynny/Zwolniony/Niezarejestrowany), name, regon, krs, accountNumbers[], registrationLegalDate, removalDate, restorationDate, hasVirtualAccounts, adresy.

Weryfikacja rachunku bankowego

GET /v1/vat/{nip}/bank-account/{account}

Odpowiada na pytanie „czy ten rachunek należał do tego podatnika tego dnia” — czyli na pytanie, które decyduje o odpowiedzialności solidarnej i o kosztach uzyskania przychodu. account to NRB (26 cyfr) albo IBAN.

Skąd bierzemy potwierdzenie. Utrzymujemy własny indeks dziennego pliku płaskiego MF (3,3 mln par NIP+rachunek, odświeżany codziennie o 4:00). Gdy indeks obejmuje wskazany dzień, potwierdzenie idzie z niego (data.provider = "flat_file") — bez zużywania limitów MF. To dlatego weryfikacja rachunków skaluje się u nas do dziesiątek tysięcy dziennie.

Semantyka, na której łatwo się przejechać. Trafienie w pliku jest dowodem pozytywnym. Brak trafienia nie jest dowodem negatywnym — rachunki wirtualne są w pliku opisane maskami, których nie rozwijamy. Dlatego przy braku trafienia zawsze dopytujemy API MF (data.provider = "wl_api"), żeby nigdy nie odpowiedzieć „rachunek nie należy do podatnika”, gdy w rzeczywistości należy.

Limity MF, których nie musisz znać, bo trzymamy je po swojej stronie: 100 zapytań wyszukujących na dobę na adres IP (do 30 podmiotów w zapytaniu) i 5000 podmiotów metodą sprawdzającą. Przekroczenie blokuje adres IP do północy — razem z wyszukiwarką WWW.

Zanim wyślesz pierwsze zapytanie

Zasady wspólne dla wszystkich źródeł opisuje strona przeglądowa: uwierzytelnianie kluczem, koperta odpowiedzi, różnica między not_found a unavailable, rozliczenie zapytań i limity. Pełny kontrakt: /v1/openapi.json.

Uzyskaj dostęp do API →