# Stawka

> Stawka is a small, fast REST API for European tax data: up-to-date VAT rates for all 27 EU member states, the European Central Bank's daily euro reference exchange rates, and real-time VIES VAT-number validation. Responses are clean JSON, edge-cached for sub-second latency, authenticated with a simple Bearer API key. Data is aggregated straight from the primary sources (European Commission TEDB, the ECB, and the EU's VIES service).

Key facts:
- Coverage: standard, reduced, super-reduced and parking VAT rates for every EU-27 country.
- History: fetch the exact rates in force on any past date (immutable snapshots).
- FX: official daily ECB euro reference rates, latest or historical.
- VIES: validate any EU VAT number in real time; returns registered name/address when available.
- Change tracking: query a change log or subscribe to signed webhooks fired when a rate moves.
- Auth: Bearer API key (`Authorization: Bearer cp_live_…`). No SDK required — anything that speaks HTTP works.
- Pricing: free tier with no credit card; paid tiers raise rate/quota limits and unlock webhooks. Cancel any time.

## Getting started
- [Quickstart](https://stawka.eu/en/docs/quickstart): make your first authenticated request in minutes.
- [Authentication](https://stawka.eu/en/docs/authentication): how API keys and Bearer auth work.
- [Errors](https://stawka.eu/en/docs/errors): error format and status codes.
- [Rate limits & quotas](https://stawka.eu/en/docs/rate-limits): per-minute and monthly limits per plan.

## Endpoints
- [GET /rates](https://stawka.eu/en/docs/endpoints/rates): latest VAT rates for all EU-27 countries (and /rates/{date} for a past date).
- [GET /changes](https://stawka.eu/en/docs/endpoints/changes): recent VAT rate changes.
- [GET /fx](https://stawka.eu/en/docs/endpoints/fx): latest ECB euro reference rates (and /fx/{date} for a snapshot).
- [GET /vies/{country}/{vat}](https://stawka.eu/en/docs/endpoints/vies): validate an EU VAT number via VIES.

## Reference
- [Response schemas](https://stawka.eu/en/docs/schemas): the JSON shapes every endpoint returns.
- [Webhooks](https://stawka.eu/en/docs/webhooks): subscribing to and verifying signed rate-change events.
- [Changelog](https://stawka.eu/en/docs/changelog): notable API changes over time.
- [Interactive API reference](https://stawka.eu/docs/api): live OpenAPI explorer.
- [OpenAPI spec](https://stawka.eu/openapi.json): the machine-readable API description.

## Pages
- [Home](https://stawka.eu/en): product overview and FAQ.
- [Pricing](https://stawka.eu/en/pricing): plans and limits.