Zum Inhalt springen

Steuerrechner-API: 9 Endpoints für deine App

7 Min. Lesezeit
apisteuerrechnerentwicklerrest-apibrutto-nettoerbschaftsteuerabfindung

Warum eine Steuer-API?

Steuerberechnungen in Deutschland sind kein Spaß. Der Lohnsteuer-Programmablaufplan des BMF hat über 800 Zeilen Pseudocode. Die Erbschaftsteuer kennt drei Steuerklassen, sechs Verwandtschaftsgrade und Versorgungsfreibeträge, die vom Alter des Kindes abhängen. Und beim Weihnachtsgeld musst du die Sechstelregel korrekt umsetzen.

Wer das alles selbst implementieren will — viel Erfolg. Wir haben es schon gemacht.

Die Steuerrechner-API liefert dir fertige Berechnungen per JSON. Du schickst die Eingabedaten, wir rechnen, du bekommst das Ergebnis. Alle Berechnungen basieren auf den offiziellen BMF-Programmablaufplänen und Steuertabellen 2026.

Alle 9 Endpoints im Überblick

Gehaltsabrechnung

POST /v1/brutto-netto — Lohnsteuer, Soli, Kirchensteuer, alle Sozialversicherungsbeiträge, Arbeitgeberkosten. Steuerklassen I–VI. Der mit Abstand meistgenutzte Endpoint. Du übergibst Bruttolohn und Steuerklasse, zurück kommen Monats- und Jahreswerte für jede einzelne Abzugsposition.

POST /v1/weihnachtsgeld — Netto-Sonderzahlung mit Sechstelregel nach §39b EStG. Die Sechstelregel begrenzt die Lohnsteuer auf Sonderzahlungen — der Endpoint rechnet beide Varianten (mit und ohne) und zeigt die Ersparnis. Nützlich für Payroll-Systeme, die Jahresend-Boni abrechnen.

POST /v1/steuerklassen — III/V gegen IV/IV für Ehepaare. Rechnet beide Varianten komplett durch: Lohnsteuer, Soli, Kirchensteuer, SV-Beiträge pro Partner plus das Haushaltsnetto. HR-Portale und Personal-Finance-Apps nutzen das für den Steuerklassen-Optimierer.

Steuern berechnen

POST /v1/abfindung — Abfindungsbesteuerung mit und ohne Fünftelregelung nach §34 EStG. Zeigt die Ersparnis schwarz auf weiß. Ab 2025 läuft die Fünftelregelung nur noch über die Steuererklärung — Outplacement-Tools und Abfindungsrechner brauchen genau diese Berechnung.

POST /v1/erbschaftsteuer — Erbschaft- und Schenkungsteuer nach ErbStG. Freibeträge von 20.000 bis 500.000 EUR, Versorgungsfreibeträge für Ehepartner und Kinder, Vergleichstabelle über alle Verwandtschaftsgrade. Der Endpoint unterscheidet automatisch zwischen Erbschaft und Schenkung — modus: "schenkung" reicht.

POST /v1/einkommensteuer — Reiner §32a-Tarif: zu versteuerndes Einkommen rein, Einkommensteuer raus. Dazu Grenzsteuersatz, Durchschnittssteuersatz und Tarifzone. Das ist der Baustein, wenn du eigene Berechnungen zusammenstecken willst.

POST /v1/grunderwerbsteuer — Kaufnebenkosten bei Immobilienkauf: Grunderwerbsteuer, Notar, Grundbuch, Makler. Die Steuersätze variieren je nach Bundesland zwischen 3,5 % und 6,5 %. Der Endpoint liefert optional einen Vergleich aller 16 Bundesländer in einem Call.

Arbeit & Sparen

POST /v1/minijob — Erkennt automatisch ob Minijob (bis 603 EUR), Midijob (603–2.000 EUR) oder reguläre Beschäftigung. Berechnet SV-Beiträge für Arbeitnehmer und Arbeitgeber getrennt. Die Midijob-Gleitzone ist nicht trivial — der Endpoint übernimmt das.

POST /v1/sparplan — Zinseszinsrechner mit jährlicher Kapitalertragsteuer (25 % + Soli). Zeigt Brutto- und Netto-Endkapital, Gesamteinzahlung, Gesamtertrag und abgeführte Steuer. Für Sparplan-Vergleiche und Rentenprognosen.

Schnellstart: Erster API-Call in 30 Sekunden

Eine Brutto-Netto-Berechnung per curl:

curl -X POST https://api.rechner-hub.de/v1/brutto-netto \
  -H "Content-Type: application/json" \
  -d '{"bruttolohn": 3500, "steuerklasse": 1}'

Die Antwort sieht so aus (gekürzt):

{
  "success": true,
  "data": {
    "brutto_monat": "3500.00",
    "netto_monat": "2388.84",
    "lohnsteuer_monat": "428.58",
    "soli_monat": "0.00",
    "kv_an_monat": "271.25",
    "rv_an_monat": "325.50",
    "av_an_monat": "45.50",
    "pv_an_monat": "66.50",
    "ag_kosten_monat": "4234.25"
  },
  "input_echo": {
    "bruttolohn": "3500.00",
    "steuerklasse": 1,
    "bundesland": "Nordrhein-Westfalen",
    "kirchensteuer": false
  },
  "meta": {
    "tax_year": 2026,
    "disclaimer": "Alle Berechnungen ohne Gewähr. ..."
  }
}

Jede Response hat die gleiche Struktur: success (bool), data (die eigentliche Berechnung), input_echo (deine Eingaben inkl. angewendeter Defaults) und meta (Steuerjahr, Disclaimer). Alle Geldbeträge sind Dezimal-Strings — kein Float-Rundungschaos.

Fehlerbehandlung

Wenn etwas nicht passt, bekommst du eine klare Fehlermeldung:

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Request validation failed.",
    "details": [
      {
        "field": "bruttolohn",
        "message": "Field required",
        "type": "missing"
      }
    ]
  }
}

Fehlercodes sind maschinenlesbar (SCREAMING_SNAKE_CASE), Messages auf Englisch. Validierungsfehler kommen mit HTTP 422, logische Fehler mit 400, fehlende Auth mit 401.

Wer nutzt eine Steuer-API?

Ein HR-SaaS zeigt seinen Kunden den Nettolohn — Brutto-Netto, Weihnachtsgeld, Steuerklassenvergleich. Statt den BMF-Programmablaufplan selbst zu pflegen, ein API-Call.

Immobilienportale blenden die Grunderwerbsteuer direkt in der Exposé-Ansicht ein. Familienrecht-Plattformen rechnen Kindesunterhalt nach der Düsseldorfer Tabelle. Finanzplanungs-Tools brauchen den Sparplan nach Steuern für ihre Prognosen.

Oder ganz simpel: Du baust deinen eigenen Rechner und willst die Steuerlogik nicht selbst implementieren. Die API liefert die Berechnung, du machst das Frontend.

Technische Details

EigenschaftWert
FormatJSON rein, JSON raus
AuthAPI-Key im Header (X-RapidAPI-Key)
Rate LimitsFree 50/Tag, Pro 5.000/Monat, Ultra 50.000/Monat
Steuerjahr2026 (BMF-PAP + aktuelle SV-Werte)
GeldbeträgeDezimal-Strings, kein Float
OpenAPI3.0.2-kompatibel
Verfügbar aufRapidAPI

Was kommt als Nächstes?

In den nächsten Wochen planen wir Endpoints für Kurzarbeitergeld, Elterngeld und Progressionsvorbehalt. Was dir fehlt, schreib uns: [email protected].

Alle Änderungen stehen im API-Changelog.

Häufige Fragen

Was kostet die API?
Es gibt einen kostenlosen Free-Tier mit 50 Requests pro Tag auf RapidAPI. Das reicht zum Testen und für kleine Projekte. Für Produktion gibt es Pro (5.000 req/Monat) und Ultra (50.000 req/Monat).
Wie aktuell sind die Steuertabellen?
Alle Berechnungen nutzen die BMF-Programmablaufpläne 2026 und die aktuellen Sozialversicherungswerte. Wenn sich Werte ändern (z.B. neue BBG), aktualisieren wir die API und dokumentieren das im Changelog.
Wie genau sind die Ergebnisse?
Die Berechnungen nutzen die gleiche Logik wie die Rechner auf rechner-hub.de. Beim Brutto-Netto-Rechner stimmen die Ergebnisse centgenau mit den BMF-Referenzwerten überein. Trotzdem gilt: Kein Ersatz für individuelle Steuerberatung.
Kann ich die API ohne RapidAPI nutzen?
Aktuell läuft die API ausschließlich über RapidAPI. Ein direkter Zugang ohne Marketplace ist für später geplant.
WhatsApp Telegram X Facebook Reddit E-Mail