API do weryfikacji numerów VAT

Sprawdź, i udowodnij to.

VerifyVAT sprawdza na żywo w VIES numery VAT Twoich kontrahentów i zapisuje przy każdej kontroli oficjalny numer konsultacji. Dzięki temu możesz później pokazać, że i kiedy sprawdzałeś.

Zarejestruj się za darmo Zaloguj się

Nowe konta zaczynają z 1000 zapytań miesięcznie.

Protokół weryfikacjiPrzykład

Kod zapytania: VV-3F9A1C2E
Sprawdzony numer VAT: DE123456789
Wynik: ważny
Firma (wg VIES): Muster GmbH
Wnioskodawca: LU32633157
Znacznik czasu: 2026-10-11 01:14:09

Numer konsultacji (VIES)

WAPIAAAAZ4Kq8vDn

Zapisane na Twoim koncie, dostępne w historii i jako CSV.

udowodnione

27 + XI: Państwa członkowskie UE i Irlandia Północna, objęte przez VIES
VV-…: Unikalny kod zapytania dla każdej pojedynczej kontroli
Dowód: Oficjalny numer konsultacji jest zapisywany przy każdym zapytaniu
CSV: Pełna historia jako eksport do księgowości i kontroli

01Po co w ogóle weryfikować?

Ważny numer VAT często decyduje o opodatkowaniu

Kto sprzedaje firmom w innych krajach UE, musi wiedzieć, z kim ma do czynienia. Numer VAT kontrahenta jest tu kluczowym identyfikatorem, a jego ważność może się zmienić.

Dostawy zwolnione z podatku

Wewnątrzwspólnotowe dostawy do przedsiębiorców w innym kraju UE są co do zasady zwolnione tylko wtedy, gdy klient posługuje się ważnym numerem VAT. Bez dowodu grozi Ci doszacowanie podatku.

Odwrotne obciążenie przy usługach

Przy wielu usługach B2B podatek rozlicza nabywca. Weryfikacja pokazuje, że klient jest zarejestrowany jako przedsiębiorca, zanim wystawisz fakturę bez VAT.

Dowód podczas kontroli podatkowej

Urząd może później zapytać, czy i kiedy sprawdzałeś. Z kodem zapytania, znacznikiem czasu i numerem konsultacji masz odpowiedź, której nie musisz odtwarzać.

To nie jest doradztwo podatkowe. Jakie dowody są potrzebne w Twoim przypadku, ustal z doradcą podatkowym.

02Zwykłe lub kwalifikowane

Różnica między „ważny” a „udowodniony”

VIES zna dwa rodzaje zapytań. Dla dokumentacji liczy się drugie.

Zwykłe zapytanie

Wysyłasz tylko numer kontrahenta. VIES odpowiada, czy jest ważny. Nie ma identyfikatora zapytania, więc masz tylko własną pamięć lub zrzut ekranu.

GET /check?vat_number=DE123456789
→ { "valid": true }

Tak działa VerifyVAT przy każdym zapytaniu

Zapytanie z wnioskodawcą

Podajesz dodatkowo własny numer VAT. VIES wystawia wtedy numer konsultacji dla dokładnie tego zapytania. VerifyVAT automatycznie dołącza Twój numer VAT i zapisuje numer konsultacji.

GET /check?vat_number=DE123456789
→ { "valid": true,
    "consultation_number": "WAPIAAAAZ4Kq8vDn" }

Jak to działa

Od rejestracji do pierwszej kontroli mijają zaledwie minuty.

1
Załóż konto
Rejestrujesz się, podając dane firmy, w tym własny numer VAT. Jest on przekazywany do VIES jako wnioskodawca przy każdej kontroli; tylko tak VIES wystawia dowód.
2
Utwórz klucz
W panelu tworzysz po jednym kluczu API dla każdej aplikacji, na przykład sklepu lub ERP. Klucz możesz w każdej chwili unieważnić.
3
Wysyłaj zapytania
Wysyłasz do API numer VAT klienta. Odpowiedź, numer konsultacji i nasz kod zapytania są zapisywane od razu.

04Dla programistów

Jedno zapytanie, jedna odpowiedź

API to proste wywołanie GET z kluczem w nagłówku. W odpowiedzi dostajesz JSON z wynikiem, danymi firmy wg VIES i dowodem. Numer VAT klienta wpisujesz z prefiksem kraju, na przykład DE123456789.

Każde zapytanie dostaje unikalny kod (VV-…), także nieudane.
Miesięczny limit i limit na minutę są ustalone dla konta i widoczne w panelu.
Gdy VIES jest niedostępny, dostajesz 502 i kod zapytania. Nic nie jest błędnie zgłaszane jako ważne.

Zapytanie

curl "https://verifyvat.eu/api/v2/check?vat_number=DE123456789" \
  -H "apikey: vat_xxxxxxxx_xxxxxxxxxxxxxxxx"

Odpowiedź

{
  "request_code": "VV-3F9A1C2E",
  "valid": true,
  "query": "DE123456789",
  "company_name": "Muster GmbH",
  "company_address": "Musterstraße 1, 10115 Berlin",
  "consultation_number": "WAPIAAAAZ4Kq8vDn",
  "vies_request_date": "2026-10-11T01:14:09.000Z",
  "proof_available": true
}

Pola odpowiedzi

request_code: Twój kod zapytania (VV-…). Można go wyszukać w panelu.
valid: true, jeśli VIES uznaje numer za ważny, w przeciwnym razie false.
company_name / company_address: Nazwa i adres wg VIES, jeśli państwo członkowskie je udostępnia.
consultation_number: Numer konsultacji z VIES. To Twój dowód.
vies_request_date: Czas zapytania według VIES.
proof_available: true, jeśli VIES wystawił numer konsultacji.

Kody statusu

Nieważny numer to nie błąd: dostajesz 200 i valid: false.

200: Zapytanie przetworzone, wynik w polu valid.
400: Brakuje vat_number lub ma nieprawidłowy format.
401: Brakuje nagłówka apikey albo klucz jest nieprawidłowy lub unieważniony.
402: Miesięczny limit został wykorzystany.
403: W koncie nie zapisano jeszcze własnego numeru VAT.
429: Przekroczono limit na minutę. Poczekaj chwilę i spróbuj ponownie.
502: VIES jest obecnie niedostępny. Zapytanie zapisano wraz z kodem.

Co widzisz na swoim koncie

Panel jest zbudowany tak, byś każdą kontrolę odnalazł później w kilka sekund.

Historia

Wszystkie zapytania z kodem, wynikiem, firmą, numerem konsultacji i znacznikiem czasu. Wyszukiwanie po kodzie, numerze VAT i numerze konsultacji.

Eksport CSV

Pełna historia jako plik dla księgowości lub kontroli.

Kontrola ręczna

Sprawdź pojedynczy numer ręcznie. Twoja firma jest już wpisana jako wnioskodawca.

Wiele kluczy

Jeden klucz na system, unieważniany osobno, żebyś zawsze wiedział, skąd przyszło zapytanie.

Wykorzystanie

Wykorzystany i pozostały limit miesięczny, limit na minutę i odsetek udanych zapytań na pierwszy rzut oka.

Pomoc

Dokumentacja z przykładami i formularz pomocy dostępny z każdej strony.

Do czego używają go zespoły

Sklep internetowy i kasa

Sprawdź numer VAT w chwili, gdy klient wpisuje go przy zamówieniu, i wystaw fakturę odpowiednio do wyniku.

ERP i księgowość

Sprawdzaj nowych kontrahentów przy zakładaniu i regularnie weryfikuj bazę. Numer konsultacji dołącz do dokumentu.

SaaS i onboarding

Weryfikuj klientów biznesowych przy rejestracji, bez ręcznego szukania na stronie urzędowej.

06Bezpieczeństwo

Twoje dostępy i dane są chronione

Powierzasz nam dostęp do API i dane firmy. Dlatego obowiązują te podstawowe zasady:

Szyfrowane połączenie

Wszystkie wywołania odbywają się przez HTTPS.

Chronione klucze API

Klucze są przechowywane w postaci zaszyfrowanej i można je w każdej chwili unieważnić pojedynczo.

Ochrona przed nadużyciami

Logowanie i API są ograniczone przed zgadywaniem haseł i przeciążeniem.

Oddzielone konta

Każdy klient widzi wyłącznie własne zapytania i klucze.

Pojęcia w skrócie

Numer VAT: Numer identyfikacyjny VAT. Zaczyna się od prefiksu kraju, np. PL dla Polski, po którym następuje numer.
VIES: System wymiany informacji o VAT Komisji Europejskiej. Przekazuje Twoje zapytanie do krajowej administracji podatkowej.
Numer konsultacji: Identyfikator, pod którym VIES dokumentuje zapytanie z wnioskodawcą.
Wnioskodawca: To Ty: Twój własny numer VAT, wysyłany razem z zapytaniem.
Kod zapytania: Krótki kod VV-… z VerifyVAT. Jest unikalny dla zapytania i można go wyszukać w panelu.

Najczęstsze pytania

Dlaczego potrzebuję własnego numeru VAT?+

VIES wystawia numer konsultacji tylko wtedy, gdy podano wnioskodawcę. Bez zapisanego numeru VAT API nie jest więc aktywne.

Czym jest numer konsultacji?+

To identyfikator, pod którym VIES dokumentuje zapytanie z wnioskodawcą. Przechowujesz go jako dowód razem z dokumentami.

Skąd pochodzą dane?+

Wszystko pochodzi z VIES, usługi Komisji Europejskiej. VerifyVAT nie jest ofertą Komisji Europejskiej.

Jakie kraje są objęte?+

Wszystkie 27 państw członkowskich UE oraz Irlandia Północna (XI). Numerów ze Szwajcarii, Wielkiej Brytanii i innych państw trzecich VIES nie zna.

Co oznacza „nieważny”?+

VIES nie uznaje numeru za ważny w chwili zapytania. Może to być literówka, numer jeszcze nieaktywny lub usunięty. W razie wątpliwości zapytaj kontrahenta.

Co się dzieje, gdy VIES jest niedostępny?+

API odpowiada kodem 502 i podaje kod zapytania. Nic nie jest zgłaszane jako ważne. Zapytanie możesz wysłać ponownie później.

Czy mogę używać tego bez programowania?+

Tak. Panel ma ręczny weryfikator, w którym Twoja firma jest już wpisana jako wnioskodawca.

Ile to kosztuje?+

Obecnie nic. Swój limit zobaczysz w panelu.

Gotowy na pierwszą kontrolę?

Załóż konto, wygeneruj klucz i zaczynaj. To zajmuje kilka minut.