German VAT Exchange Rates API

What this API does

The German VAT Exchange Rates API exposes the official monthly euro reference rates published by the Bundesfinanzministerium (BMF) as a clean JSON endpoint. These rates are the legally required basis for converting foreign-currency invoices in German VAT filings (§ 16 Abs. 6 UStG). Instead of parsing the monthly BMF PDFs yourself, accounting tools, ERP systems, and tax advisors can fetch the current and historical rates over HTTPS.

Data source

German Federal Ministry of Finance (BMF), original publication

Updates

monthly, as soon as the BMF publishes a new monthly rate

Yearly averages

recomputed automatically once the BMF confirms all twelve months

Format

JSON over HTTPS, Bearer token authentication

Access

personal token issued on request, free for fair use

Typical use cases

• Accounting and ERP systems converting foreign-currency turnover
• Tax advisors preparing periodic and annual German VAT returns
• Invoicing software with multi-currency support
• Reporting and BI pipelines that need the official BMF reference rates

Request access

Using the API requires a personal token that I issue manually. Send me a short message at dimitri.missoh+uuk@gmail.com with a brief description of your use case.

Authentication

Send your API key in the Authorization header on every request to /api/v1/*.

curl -H "Authorization: Bearer ukk_…" \
  https://ukk-api.xevieso.com/api/v1/currencies

Rate limiting

60 requests per minute per key (sliding window). Responses include X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset. Exceeding the limit returns 429 with a Retry-After header.

Endpoints

Data source

Rates are ingested monthly from the PDFs published by the Bundesfinanzministerium. Yearly averages are recomputed once the ministry's Gesamtübersicht confirms all twelve months.