API-Dokumentation

Getting Started

Neun Endpoints, alle POST, alle JSON. Schick deine Eingabe, bekomm eine Berechnung zurück. Jede Response folgt demselben Aufbau:

{
  "success": true,
  "data": { ... },
  "input_echo": { ... },
  "meta": {
    "tax_year": 2026,
    "disclaimer": "Alle Berechnungen ohne Gewähr."
  }
}

input_echo spiegelt die Werte zurück, die tatsächlich verwendet wurden — inklusive Defaults, die du nicht mitgeschickt hast. Praktisch zum Debuggen.

Geldbeträge kommen als Strings, nicht als Floats — "2372.83" statt 2372.83. So gibt es keine Rundungsfehler bei Steuerberechnungen.

Fehlerbehandlung

Bei ungültiger Eingabe bekommst du:

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Request validation failed.",
    "details": [
      {
        "field": "bruttolohn",
        "message": "Input should be greater than or equal to 0",
        "type": "greater_than_equal"
      }
    ]
  }
}

POST /v1/brutto-netto

Brutto-Netto-Berechnung für Deutschland.

Request-Felder

Minimal-Beispiel

{"bruttolohn": 3500, "steuerklasse": 1}

Response-Felder

Arbeitnehmer: brutto_monat, brutto_jahr, netto_monat, netto_jahr, abzuege_gesamt_monat. Steuer-Aufschlüsselung: lohnsteuer_monat, soli_monat, kirchensteuer_monat. SV-Beiträge: kv_an_monat, pv_an_monat, rv_an_monat, av_an_monat, sv_gesamt_monat.

Arbeitgeber: ag_kv, ag_pv, ag_rv, ag_av, ag_umlage, ag_gesamt, ag_kosten_gesamt.

Beitragssätze: kv_satz, pv_satz, rv_satz, av_satz.

Szenarien: 5 Was-wäre-wenn-Berechnungen bei verschiedenen Bruttogehalts-Stufen (±500, ±1.000, +5.000 EUR).

POST /v1/grunderwerbsteuer

Grunderwerbsteuer und Kaufnebenkosten beim Immobilienkauf.

Request-Felder

Minimal-Beispiel

{"kaufpreis": 300000, "bundesland": "Bayern"}

Response-Felder

kaufpreis, bundesland, steuersatz, grunderwerbsteuer (die Steuer selbst). notarkosten, notar_prozent, grundbuchkosten, grundbuch_prozent (Notar + Grundbuch). maklerkosten, makler_prozent (0 wenn ohne Makler). nebenkosten_gesamt, nebenkosten_prozent, kaufpreis_gesamt (Gesamtkosten).

bundeslaender_vergleich — Array mit allen 16 Bundesländern, deren Steuersatz und Grunderwerbsteuer für deinen Kaufpreis. Sortiert nach Steuersatz.

POST /v1/minijob

Bestimmt Beschäftigungsart (Minijob bis 556 EUR, Midijob 556–2.000 EUR, regulär) und rechnet SV-Beiträge aus.

Request-Felder

Beispiele

{"bruttogehalt": 550}

{"bruttogehalt": 1200, "kinderlos_ueber_23": true, "bundesland": "Sachsen"}

Response-Felder

status ("minijob", "midijob" oder "volle_sv"). brutto, netto, sv_abzuege. kv_beitrag, pv_beitrag, rv_beitrag, av_beitrag (Aufschlüsselung). stunden_mindestlohn — Arbeitsstunden bei 13,90 EUR/h Mindestlohn.

vergleich_plus_100, vergleich_minus_100 — was sich am Netto ändert bei ±100 EUR brutto. hinweis — Erklärungstext zum Beschäftigungsstatus auf Deutsch.

POST /v1/abfindung

Berechnet die Steuer auf eine Abfindung mit und ohne Fünftelregelung nach §34 EStG.

Request-Felder

Minimal-Beispiel

{"abfindung": 50000, "jahresbrutto": 60000}

Response-Felder

fuenftelregel: est, soli, kirchensteuer, steuer_gesamt, netto, effektiv_prozent — Besteuerung mit Fünftelregelung.

normal: Gleiche Felder — Normalbesteuerung ohne Fünftelregelung.

ersparnis — Steuerersparnis durch die Fünftelregelung in EUR.

POST /v1/erbschaftsteuer

Erbschaft- und Schenkungsteuer nach ErbStG. Steuerklassen I–III, Freibeträge und Verwandtschaftsvergleich.

Request-Felder

Minimal-Beispiel

{"wert": 500000, "verwandtschaft": "Kind"}

Response-Felder

steuerklasse (I/II/III), freibetrag, versorgungsfreibetrag, freibetrag_gesamt, steuerpflichtiger_erwerb.

steuersatz, steuer, effektiv_prozent, netto, modus_label.

vergleich — Array mit Steuerberechnung für alle 12 Verwandtschaftsgrade.

POST /v1/weihnachtsgeld

Netto-Sonderzahlung mit Vergleich reguläre Hochrechnung vs. Sechstelregel (§39b EStG).

Request-Felder

Minimal-Beispiel

{"monatslohn": 4000, "sonderzahlung": 4000}

Response-Felder

brutto_sonderzahlung.

regulaer: lohnsteuer, soli, kirchensteuer, sv_abzuege, netto — Hochrechnung (seit 2025 Standard beim Arbeitgeber).

sechstelregel: Gleiche Felder — Rückholbar über Steuererklärung.

ersparnis, sechstel_anwendbar.

POST /v1/steuerklassen

Vergleich Steuerklassen III/V vs. IV/IV für Ehepaare.

Request-Felder

Minimal-Beispiel

{"brutto_partner_1": 5000, "brutto_partner_2": 3000}

Response-Felder

variante_3_5: partner_1 und partner_2 jeweils mit steuerklasse, brutto, netto, lohnsteuer, soli, kirchensteuer, sv_gesamt. Plus haushalt_netto.

variante_4_4: Gleiche Struktur.

differenz_monat, differenz_jahr, empfehlung, warnungen.

POST /v1/einkommensteuer

Berechnet die Einkommensteuer aus dem zu versteuernden Einkommen (zvE) nach §32a EStG. Mit Splitting, Soli und Kirchensteuer.

Request-Felder

Minimal-Beispiel

{"zve": 50000}

Response-Felder

einkommensteuer, solidaritaetszuschlag, kirchensteuer, steuer_gesamt — Steuern in EUR.

grenzsteuersatz — marginale Steuerbelastung auf den nächsten Euro in Prozent. durchschnittssteuersatz — ESt geteilt durch zvE in Prozent. belastungsquote — Gesamtsteuer (ESt+Soli+KiSt) geteilt durch zvE.

tarifzone — zone (1–5), name und satz der aktuellen Tarifzone.

grundfreibetrag — Grundfreibetrag in EUR (verdoppelt bei Splitting).

POST /v1/sparplan

Sparplan- und Zinseszinsrechner mit Kapitalertragsteuer (25% KapESt + Soli + optional Kirchensteuer).

Request-Felder

Minimal-Beispiel

{"monatliche_sparrate": 500, "laufzeit_jahre": 20}

Response-Felder

endkapital_brutto, endkapital_netto — Endkapital vor/nach Steuern. einzahlungen_gesamt — Summe aller Einzahlungen.

ertraege_brutto, ertraege_netto — Erträge vor/nach Steuern. steuer_gesamt — Kapitalertragsteuer gesamt. steuersatz_effektiv — Effektiver Steuersatz inkl. Soli/KiSt.

jahresverlauf — Array mit jährlicher Entwicklung (einzahlungen_kumuliert, ertraege_kumuliert, steuer_kumuliert, kapital_brutto, kapital_netto, sparrate_monat).

Bundesland-Werte

Exakte Schreibweise verwenden (Groß-/Kleinschreibung beachten):