Introduction

What is VAT Engine?

VAT Engine is a production-ready API for calculating EU Value Added Tax. It serves real-time VAT rates sourced from the official EU TEDB (Taxes in Europe Database) and supports all 27 EU member states with 37 curated tax classes.

Key Features

• EU-wide coverage — All 27 EU member states with standard and reduced VAT rates.
• 37 tax classes — Standard, food, books, pharmaceuticals, accommodation, and more — derived from the official EU TEDB.
• Accurate calculations — Integer arithmetic in minor currency units (cents) to avoid floating-point errors.
• Historical rates — Query VAT rates for any past or present date.
• Compliance tracking — Transaction audit history and exports, plus a separate committed supply-event compliance ledger for the OSS Overview, threshold alerts, Filing Prep, OSS/IOSS registration metadata, correction-aware Union OSS preview reports, locked return/export history, source/store tags, and multi-currency ECB-backed EUR normalization.
• SME thresholds — EU Small Business Scheme exemption and cash-accounting thresholds for all 27 member states, including national-currency amounts for non-eurozone countries.
• Modern Go backend — Runs on Fiber v3 with reverse-proxy-aware request handling, structured errors, and fully migrated middleware/test coverage.
• Simple REST API — JSON request/response with straightforward authentication via API keys.
• Self-service API keys — Generate, rotate, and revoke API keys from the dashboard.
• Secure account dashboard — Manage profile details, account ID, subscription access, password changes, 2FA, and backup-code regeneration from self-service dashboard pages.
• Integrations workspace — Connect storefronts, manage encrypted connector tokens plus any platform-specific secret material a connector requires, define source aliases and product tax mappings, inspect recent connector activity, track Shopify privacy requests, queue manual resync or replay work, and manually import canonical committed-order events into the committed supply ledger from the dashboard. Durable backend audit events cover privacy workflows plus classification-critical source alias changes, product tax mapping changes, and imported-event review decisions. Filed-period snapshots stay immutable: new original-period committed-order imports are blocked when their supply_date overlaps a relevant locked or filed VAT return period, while supported late Shopify corrections are rerouted into the next open correction date instead of rewriting the closed period directly. Shopify privacy requests now run through a background review worker for safe deterministic cases, while retained-evidence customers/data_request exports and remaining shop/redact metadata cleanup still require operator follow-up. Customer or order identifiers are minimized immediately for completed or legally retained redaction outcomes and after the retention window for completed data-request flows.

Quick Example

curl -X POST https://api.vat-engine.app/v1/vat/calculate \-H "X-API-Key: vat_production_your_key_here" \-H "Content-Type: application/json" \-d '{  "country": "DE",  "currency": "EUR",  "gross_amount_minor": 11900,  "price_includes_vat": true,  "tax_class_id": "standard"}'

Response:

{
  "country": "DE",
  "currency": "EUR",
  "vat_rate_bps": 1900,
  "gross_amount_minor": 11900,
  "net_amount_minor": 10000,
  "vat_amount_minor": 1900
}

Next Steps