API-Referenz

Umsatzsteuer-Umrechnungskurse

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

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.