Przejdź do głównej zawartości

Stawka API

Stawka udostępnia cztery zbiory danych w trybie tylko-do-odczytu, dostępne przez jedno, proste API JSON:

  • /rates — aktualne i historyczne stawki VAT dla wszystkich krajów UE-27, pobierane codziennie z bazy TEDB Komisji Europejskiej.
  • /changes — diff endpointu /rates z dnia na dzień. Zmaterializowany changelog tego, które stawki kiedy się zmieniły, z możliwością filtrowania po dacie i kraju.
  • /fx — referencyjne kursy euro publikowane przez EBC (codzienny fixing o 16:00 CET), aktualne i historyczne.
  • /vies/{country}/{vat} — walidacja numeru VAT na żądanie, przez usługę VIES Komisji Europejskiej.

Jeśli wolisz subskrypcję zamiast pollingu, webhooki wypchną te same zdarzenia — w tym rates.changed — pod wskazany przez Ciebie URL.

Każdy endpoint obsługuje wyłącznie metodę GET i zwraca JSON. Błędy wykorzystują wspólną kopertę:

{ "error": "<code>" }

Powierzchnia API i kształty odpowiedzi opisane w tej dokumentacji są stabilne. Zmiany łamiące kompatybilność są wprowadzane jako dodatkowe pola wraz z okresem wycofania — zobacz changelog.