API-Referenz

Umsatzsteuer-Umrechnungskurse API

Token-authentifizierte JSON-API für die vom Bundesfinanzministerium monatlich veröffentlichten Euro-Referenzkurse zur Umsatzsteuererklärung gemäß § 16 Abs. 6 UStG.

Was diese API leistet

Die Umsatzsteuer-Umrechnungskurse-API stellt die offiziellen monatlichen Euro-Referenzkurse des Bundesfinanzministeriums (BMF) maschinenlesbar bereit. Die Kurse sind für die Umrechnung in Fremdwährung gestellter Rechnungen im Rahmen der Umsatzsteuer maßgeblich (§ 16 Abs. 6 UStG). Statt monatlich PDFs zu parsen, erhalten Steuerberater, Buchhaltungssoftware und ERP-Systeme die aktuellen Werte über eine schlanke JSON-Schnittstelle.

Datenquelle: Bundesfinanzministerium (BMF), Originalveröffentlichung
Aktualisierung: monatlich, sobald das BMF einen neuen Monatskurs publiziert
Jahresdurchschnitt: automatische Neuberechnung nach Bestätigung der Gesamtübersicht
Format: JSON über HTTPS, Bearer-Token-Authentifizierung
Zugang: persönlicher Token auf Anfrage, kostenfrei für faire Nutzung

Typische Anwendungsfälle

Buchhaltungs- und ERP-Systeme zur Umrechnung von Auslandsumsätzen
Steuerkanzleien für die Erstellung von USt-Voranmeldungen und Jahreserklärungen
Rechnungssoftware mit Mehrwährungsunterstützung
Reporting- und BI-Pipelines, die offizielle BMF-Kurse benötigen

Zugang anfordern

Für die Nutzung der API benötigen Sie einen persönlichen Token, den ich manuell ausstelle. Schreiben Sie mir eine kurze Nachricht an dimitri.missoh+uuk@gmail.com mit einer kurzen Beschreibung Ihres Anwendungsfalls.

Authentifizierung

Senden Sie Ihren API-Schlüssel im Authorization-Header bei jeder Anfrage an /api/v1/*.

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

Anfragegrenze

60 Anfragen pro Minute und Schlüssel (gleitendes Zeitfenster). Antworten enthalten X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset. Bei Überschreitung wird 429 mit Retry-After-Header zurückgegeben.

Endpunkte

GET/api/v1/currencies

GET/api/v1/rates/monthly?currency=USD&year=2025&month=3

GET/api/v1/rates/monthly?currency=USD&year=2025

GET/api/v1/rates/yearly?currency=USD&year=2024

GET/api/v1/rates?currency=USD&from=2024-01&to=2025-12

GET/api/v1/convert?amount=100&from=USD&to=EUR&year=2025&month=3

Datenquelle

Die Kurse werden monatlich aus den vom Bundesfinanzministerium veröffentlichten PDFs importiert. Jahresdurchschnittswerte werden neu berechnet, sobald die Gesamtübersicht alle zwölf Monate bestätigt.