API Reference

Get accurate EU VAT rates for any country, product type, and customer type.

Base URL: https://vatrate.eu

GET /api/v1/rate

Get the VAT rate for a specific transaction.

Parameters

Parameter	Required	Description
country	Required	2-letter country code (e.g., DE, FR, IT)
type	Optional	Product type: saas, ebooks, online_courses, digital_services
customer	Optional	consumer (default) or business
vat_number	Optional	VAT number for B2B validation

Example Request

/api/v1/rate?country=DE&type=saas&customer=consumer

Response

{
  "country": "DE",
  "country_name": "Germany",
  "product_type": "saas",
  "customer_type": "consumer",
  "rate": 19,
  "mechanism": "standard",
  "currency": "EUR",
  "note": "Umsatzsteuer 19%",
  "oss_applicable": true,
  "oss_threshold": {
    "amount": 10000,
    "currency": "EUR",
    "exceeded": false
  },
  "valid_from": "2024-01-01",
  "last_updated": "2026-04-06"
}

GET /api/v1/rates

Get all VAT rates for a country.

Parameters

Parameter	Required	Description
country	Required	2-letter country code (e.g., IT)

Example Request

/api/v1/rates?country=IT

Response

{
  "country": "IT",
  "country_name": "Italy",
  "vat": {
    "standard": 22,
    "reduced": 10,
    "super_reduced": 4,
    "parking": null,
    "zero": 0
  },
  "rates_by_type": {
    "saas_b2b": 0,
    "saas_b2c": 22,
    "ebooks_b2b": 0,
    "ebooks_b2c": 4,
    "online_courses_b2b": 0,
    "online_courses_b2c": 22
  },
  "oss_enabled": true
}

POST /api/v1/products

Classify a product description to determine applicable VAT.

Parameters

Parameter	Required	Description
country	Required	2-letter country code
description	Required	Product description (e.g., "cloud accounting software")

Example Request

POST /api/v1/products
Body: { "country": "IT", "description": "abbonamento mensile software contabilità cloud" }

Response

{
  "product_type": "saas",
  "classification": "digital_service",
  "confidence": 0.95,
  "b2b": { "rate": 0, "mechanism": "reverse_charge" },
  "b2c": { "rate": 22, "mechanism": "standard" },
  "note": "Cloud accounting software classified as SaaS"
}

GET /api/v1/oss-threshold

Check if your total EU B2C digital sales exceed the €10k OSS threshold.

Parameters

Parameter	Required	Description
home_country	Required	Your home country (2-letter code)
sales_XX	Optional	Sales per country (e.g., sales_fr=8000&sales_de=5000)

Example Request

/api/v1/oss-threshold?home_country=IT&sales_fr=8000&sales_de=5000

Response

{
  "home_country": "IT",
  "total_b2c_digital_sales": 13000,
  "threshold": 10000,
  "threshold_exceeded": true,
  "countries_exceeding": ["FR", "DE"],
  "oss_required": true,
  "note": "Total €13,000 exceeds €10,000 threshold.",
  "action": "Register for OSS in Italy..."
}

GET /api/v1/alerts

Get upcoming VAT rate changes across EU countries.

Example Request

/api/v1/alerts

Response

{
  "alerts": [
    {
      "country": "EE",
      "country_name": "Estonia",
      "change": {
        "from": 20,
        "to": 22,
        "effective_date": "2027-01-01",
        "type": "standard_rate"
      }
    }
  ],
  "last_checked": "2026-04-06"
}

Getting Started

No API key required for the free tier (100 req/day per IP)
Make a GET request to /api/v1/rate?country=DE&type=saas
Parse the JSON response and apply the VAT rate in your checkout
For higher limits, subscribe to a paid plan