API-Dokumentation

Getting Started

100 Endpoints — 80 POST, 20 GET. Du schickst Eingabewerte, die API rechnet, du bekommst das Ergebnis. Jede Response hat den gleichen Aufbau:

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

input_echo zeigt dir, welche Werte die API tatsächlich benutzt hat — auch die Defaults, die du nicht mitgeschickt hast. Spart Zeit beim Debuggen.

Geldbeträge sind Strings, keine Floats — "2372.83" statt 2372.83. Damit hast du bei Steuerbeträgen keine IEEE-754-Rundungsprobleme.

Neue Endpoints in 2026.30

3 neue Gemeinde-Datenfeeds — alle per 8-stelligem Amtlichen Gemeindeschlüssel (AGS), ETag/304-cachebar. Details unten und im Changelog.

• GET /v1/mietstufe/{ags} — Wohngeld-Mietenstufe I–VII (WoGV-Anlage, gültig ab 01.01.2023); belegt das Mietstufe-Feld im Wohngeld-Rechner vor
• GET /v1/einkommen/{ags} — Gesamtbetrag der Einkünfte je Steuerpflichtigem (§ 2 Abs. 3 EStG) als Zeitreihe — nicht das Durchschnittsgehalt
• GET /v1/schulden/{ags} — kommunale Schulden auf Kreisebene (Kernhaushalt, Stichtag 31.12.) inkl. Schuld je Einwohner

Neue Endpoints in 2026.29

14 neue Endpoints — 7 Rechner und 7 Batches. Details und Response-Schemas findest du im Changelog und in der OpenAPI-Spec.

• POST /v1/verpflegungsmehraufwand — Verpflegungsmehraufwand (Spesen) nach § 9 Abs. 4a EStG
• POST /v1/kuendigungsfrist — Kündigungsfrist nach § 622 BGB
• POST /v1/teilzeit — Netto-Vergleich Vollzeit vs. Teilzeit
• POST /v1/vl — Arbeitnehmer-Sparzulage nach § 13 5. VermBG (vermögenswirksame Leistungen)
• POST /v1/rentenpunkte — Rentenpunkte nach §§ 63 ff. SGB VI
• POST /v1/rentenluecke — Rentenlücken-Berechnung
• POST /v1/krankenkassenbeitrag — KV- und PV-Beitrag mit AN/AG-Split
• POST /v1/einkommensteuer/batch, /v1/netto-brutto/batch, /v1/gewerbesteuer/batch, /v1/grunderwerbsteuer/batch, /v1/kapitalertragsteuer/batch, /v1/kindesunterhalt/batch, /v1/firmenwagen/batch — Batch-Varianten mit Per-Item-Error-Isolation; Cap 200 Items für netto-brutto und firmenwagen, alle anderen Cap 1.000

Fehlerbehandlung

Wenn was nicht passt, sieht die Response so aus:

{
  "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

Monatliches Bruttogehalt rein, komplette Gehaltsabrechnung raus. Lohnsteuer, SV, Arbeitgeberkosten — alles aufgeschlüsselt.

Request-Felder

Minimal-Beispiel

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

Response-Felder

Arbeitnehmer: brutto_monat/jahr, netto_monat/jahr, abzuege_gesamt_monat. Steuern: lohnsteuer_monat, soli_monat, kirchensteuer_monat. SV: kv_an, pv_an, rv_an, av_an, sv_gesamt (jeweils _monat).

Arbeitgeber: ag_kv, ag_pv, ag_rv, ag_av, ag_umlage, ag_gesamt, ag_kosten_gesamt (was dich der Mitarbeiter kostet).

Beitragssätze: kv_satz, pv_satz, rv_satz, av_satz — die tatsächlich angewandten Prozentsätze.

Szenarien: 5 Was-wäre-wenn-Rechnungen — was sich bei ±500, ±1.000 und +5.000 EUR brutto ändert.

POST /v1/brutto-netto

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

{
  "success": true,
  "data": {
    "netto_monat": "2351.83",
    "lohnsteuer_monat": "386.92",
    "soli_monat": "0.0",
    "sv_gesamt_monat": "761.25",
    "ag_kosten_gesamt": "4296.25"
  }
}

POST /v1/grunderwerbsteuer

Grunderwerbsteuer, Notar, Grundbuch und Makler — alle Kaufnebenkosten auf einen Blick.

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 — alle 16 Bundesländer nebeneinander: Steuersatz und Grunderwerbsteuer für deinen Kaufpreis. Sortiert nach Satz.

POST /v1/grunderwerbsteuer

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

{
  "success": true,
  "data": {
    "grunderwerbsteuer": "10500.0",
    "notarkosten": "4500.0",
    "nebenkosten_gesamt": "16500.0",
    "kaufpreis_gesamt": "316500.0",
    "bundeslaender_vergleich": [...]
  }
}

POST /v1/minijob

Erkennt ob Minijob (≤556 €), Midijob (556–2.000 €) oder volle SV und rechnet die Beiträge für AN und AG 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/minijob

{"bruttogehalt": 550}

{
  "success": true,
  "data": {
    "status": "minijob",
    "brutto": "550.0",
    "netto": "550.0",
    "sv_abzuege": "0.0",
    "stunden_mindestlohn": "39.6"
  }
}

POST /v1/abfindung

Abfindung mit und ohne Fünftelregelung (§34 EStG) durchrechnen. Zeigt die Ersparnis in Euro.

Request-Felder

Minimal-Beispiel

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

Response-Felder

fünftelregel: 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/abfindung

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

{
  "success": true,
  "data": {
    "fuenftelregel": {
      "steuer_gesamt": "18279.36",
      "netto": "31720.64",
      "effektiv_prozent": "36.56"
    },
    "normal": {
      "steuer_gesamt": "20930.27",
      "netto": "29069.73"
    },
    "ersparnis": "2650.91"
  }
}

POST /v1/erbschaftsteuer

Erbschaft oder Schenkung — Freibetrag, Steuerklasse und Steuerlast nach ErbStG. Vergleicht alle 12 Verwandtschaftsgrade.

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/erbschaftsteuer

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

{
  "success": true,
  "data": {
    "steuerklasse": "I",
    "freibetrag": "400000",
    "steuersatz": 11,
    "steuer": "11000.0",
    "effektiv_prozent": "2.2",
    "netto": "489000.0",
    "vergleich": [...]
  }
}

POST /v1/weihnachtsgeld

Was bleibt vom Bonus netto? Lohnsteuer, Soli, Kirchensteuer und SV auf eine Sonderzahlung — sonstiger Bezug nach §39b Abs. 3 EStG.

Request-Felder

Minimal-Beispiel

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

Response-Felder

brutto_sonderzahlung — der Brutto-Bonus.

lohnsteuer, soli, kirchensteuer, sv_abzuege — die einzelnen Abzüge auf die Sonderzahlung (sonstiger Bezug, §39b Abs. 3 EStG). netto — was nach allen Abzügen bleibt.

POST /v1/weihnachtsgeld

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

{
  "success": true,
  "data": {
    "brutto_sonderzahlung": "4000.0",
    "lohnsteuer": "991.0",
    "soli": "0.0",
    "kirchensteuer": "0.0",
    "sv_abzuege": "615.22",
    "netto": "2393.78"
  }
}

POST /v1/steuerklassen

III/V oder IV/IV — was bringt mehr Netto? Rechnet beide Varianten für Ehepaare durch.

Request-Felder

Minimal-Beispiel

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

Response-Felder

variante_3_5: Jeder Partner mit steuerklasse, brutto, netto, lohnsteuer, soli, kirchensteuer, sv_gesamt. Dazu haushalt_netto für den ganzen Haushalt.

variante_4_4: Gleiche Struktur, andere Steuerklassen.

differenz_monat, differenz_jahr — der Unterschied zwischen beiden Varianten. empfehlung — Klartext. warnungen — Sonderfälle.

POST /v1/steuerklassen

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

{
  "success": true,
  "data": {
    "differenz_monat": "361.17",
    "differenz_jahr": "4334.04",
    "empfehlung": "SK III/V bringt ...",
    "variante_3_5": {...},
    "variante_4_4": {...}
  }
}

POST /v1/einkommensteuer

Reiner ESt-Tarif nach §32a EStG. zvE rein, Steuer + Grenzsteuersatz + Tarifzone raus. Splitting, Soli und KiSt eingebaut.

Request-Felder

Minimal-Beispiel

{"zve": 50000}

Response-Felder

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

grenzsteuersatz — was der nächste Euro an Steuer kostet. durchschnittssteuersatz — ESt geteilt durch zvE. belastungsquote — Gesamtlast (ESt + Soli + KiSt) in Prozent vom Einkommen.

tarifzone — in welcher der 5 Zonen du liegst, mit Name und Satzbereich.

grundfreibetrag — der steuerfreie Grundbetrag (verdoppelt sich bei Splitting).

POST /v1/einkommensteuer

{"zve": 50000}

{
  "success": true,
  "data": {
    "einkommensteuer": "10548.0",
    "grenzsteuersatz": "35.0",
    "durchschnittssteuersatz": "21.1",
    "tarifzone": {
      "zone": 3,
      "name": "Obere Progressionszone",
      "satz": "24–42 %"
    }
  }
}

POST /v1/sparplan

Zinseszins mit jährlicher Steuerabrechnung. 25 % KapESt + Soli, optional KiSt. Sparerpauschbetrag und Dynamik eingebaut.

Request-Felder

Minimal-Beispiel

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

Response-Felder

endkapital_brutto, endkapital_netto — was am Ende rauskommt, vor und nach Steuer. einzahlungen_gesamt — wie viel du insgesamt eingezahlt hast.

ertraege_brutto, ertraege_netto — reiner Gewinn, vor und nach Steuer. steuer_gesamt — KapESt über die gesamte Laufzeit. steuersatz_effektiv — effektiver Satz inkl. Soli und KiSt.

jahresverlauf — Jahr für Jahr: kumulierte Einzahlungen, Erträge, gezahlte Steuer, Kapital brutto/netto und aktuelle Sparrate.

POST /v1/sparplan

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

{
  "success": true,
  "data": {
    "einzahlungen_gesamt": "120000.0",
    "endkapital_brutto": "242719.78",
    "endkapital_netto": "215333.62",
    "steuer_gesamt": "27386.16",
    "jahresverlauf": [...]
  }
}

POST /v1/netto-brutto

Du gibst dein Wunsch-Netto ein und bekommst das nötige Brutto. Umkehrrechnung mit identischer Steuer- und SV-Logik.

Request-Felder

Minimal-Beispiel

{"nettolohn": 2500, "steuerklasse": 1}

POST /v1/lohnkosten-netto

Wie viel Netto bleibt bei einem AG-Gesamtkosten-Budget? Rechnet rückwärts: Budget rein, Brutto und Netto raus.

Request-Felder

Minimal-Beispiel

{"lohnkosten_ziel": 5000, "steuerklasse": 1}

POST /v1/arbeitgeber-kosten

Was kostet ein Mitarbeiter wirklich? Alle AG-Anteile einzeln: KV, PV, RV, AV, U1, U2, Insolvenzgeld.

Request-Felder

Minimal-Beispiel

{"brutto_monat": 4000}

POST /v1/pfaendung

Pfändungsfreigrenzen nach §850c ZPO. Zeigt pfändbaren und unpfändbaren Betrag, abhängig von Unterhaltspflichten.

Request-Felder

Minimal-Beispiel

{"nettoeinkommen": 2500}

POST /v1/gewerbesteuer

Gewerbesteuer für EU, PG oder KG. Freibetrag, Messzahl 3,5 %, §35-Anrechnung, Hebesatz-Vergleich. Hebesatz direkt, per AGS oder per Gemeindename.

Request-Felder

Minimal-Beispiel

{"gewinn": 100000, "rechtsform": "kapitalgesellschaft", "hebesatz": 490}

GET /v1/hebesaetze

Durchsucht 10.754 deutsche Gemeinden nach Name. Gibt Hebesatz, AGS und Bundesland zurück.

Query-Parameter

Beispiel

GET /v1/hebesaetze?q=M%C3%BCnchen&limit=5

GET /v1/hebesaetze/{ags}

Einzelabfrage per 8-stelligem AGS, z.B. GET /v1/hebesaetze/09162000

POST /v1/koerperschaftsteuer

GmbH-Gesamtbelastung: KSt 15 % + Soli + GewSt. Bei Ausschüttung kommt KapESt dazu. Vergleicht mit Einzelunternehmen.

Request-Felder

Minimal-Beispiel

{"gewinn": 100000, "hebesatz": 490}

POST /v1/firmenwagen

1-%-Regel, 0,5 % für Plug-in-Hybride, 0,25 % für E-Autos (bis 70k LP). Rechnet den geldwerten Vorteil und die Netto-Differenz mit/ohne Firmenwagen.

Request-Felder

Minimal-Beispiel

{"listenpreis": 40000, "entfernung_km": 25, "antriebsart": "verbrenner", "bruttogehalt": 4000}

POST /v1/elterngeld

Basiselterngeld und ElterngeldPlus nach BEEG. Ersatzrate 65–67 %, Geschwisterbonus, Mehrlingsbonus und Teilzeit während Bezug.

Request-Felder

Minimal-Beispiel

{"nettoeinkommen_monat": 2500}

POST /v1/alg1

Arbeitslosengeld I: Bemessungsentgelt, pauschalierte Abzüge, 60/67 % Leistungssatz und Bezugsdauer nach §147 SGB III.

Request-Felder

Minimal-Beispiel

{"bruttogehalt_monat": 4000}

POST /v1/krankengeld

70 % vom Brutto, gedeckelt auf 90 % vom Netto. Zieht PV, RV und AV ab (nicht KV). Zeigt den Einkommensverlust in EUR und Prozent.

Request-Felder

Minimal-Beispiel

{"bruttogehalt_monat": 4000}

POST /v1/progressionsvorbehalt

Wie viel mehr Steuer fällt an, wenn du ALG, Elterngeld oder Krankengeld bezogen hast? Berechnet die Mehrbelastung nach §32b EStG.

Request-Felder

Minimal-Beispiel

{"einkommen": 40000, "lohnersatzleistung": 10000}

POST /v1/pendlerpauschale

Entfernungspauschale nach §9 EStG. 0,38 EUR pro Kilometer ab dem ersten. Jahresdeckel 4.500 EUR gilt für ÖPNV, Fahrrad und Mitfahrer — beim eigenen Auto gibt’s keine Obergrenze.

Request-Felder

Minimal-Beispiel

{"entfernung_km": 25, "grenzsteuersatz": 35}

POST /v1/schenkungsteuer

Schenkung zu Lebzeiten. Steuerklassen I–III, persönliche Freibeträge (20.000–500.000 EUR), Steuersätze 7–50 %. Anders als bei der Erbschaftsteuer greifen hier keine Versorgungsfreibeträge nach §17 ErbStG.

Request-Felder

Minimal-Beispiel

{"wert": 450000, "verwandtschaft": "kind"}

POST /v1/grundsteuer

Grundsteuer ab 2025 nach dem Modell des jeweiligen Bundeslands. Bundesmodell für elf Länder, dazu fünf Sondermodelle: Baden-Württemberg (Bodenwert), Bayern (Fläche), Hamburg (Wohnlage), Hessen (Fläche–Faktor), Niedersachsen (Fläche–Lage). Welche Felder du schickst, hängt vom Modell ab — die API zeigt dir in der Fehlermeldung, was fehlt.

Request-Felder

Beispiel Bayern (Flächenmodell)

{"bundesland": "Bayern", "hebesatz_prozent": 535, "grundstuecksflaeche_m2": 500, "gebaeudeflaeche_m2": 140}

POST /v1/kurzarbeitergeld

Kurzarbeitergeld nach §§95–109 SGB III. Leistungssatz 60 % ohne Kinder, 67 % mit. Grundlage ist die pauschalierte Nettoentgelt-Differenz nach §106 SGB III. Seit 2026 mit der 21 %-SV-Pauschale (vorher 20 %).

Request-Felder

Minimal-Beispiel

{"brutto_regulaer": 3200, "ausfallstunden_prozent": 50, "hat_kinder": true}

POST /v1/buergergeld

Bürgergeld-Anspruch nach SGB II. Regelbedarf, Mehrbedarfe nach §21, Kosten der Unterkunft und Einkommens-Freibeträge nach §11b — die Response zeigt den Anspruch plus Aufschlüsselung, damit du nachvollziehen kannst, wie die Abzugskette gelaufen ist.

Request-Felder

Minimal-Beispiel

{"erwachsene": 2, "kinder_alter": [8, 12], "kaltmiete": 700, "heizkosten": 120, "nettoeinkommen": 1180}

POST /v1/bafoeg

BAföG-Förderbetrag nach §§13, 13a, 23, 25, 29 BAföG. Grundbedarf plus Wohnpauschale, KV/PV-Zuschlag, Elterneinkommen mit Freibeträgen nach §25, Eigeneinkommen nach §23, Vermögensanrechnung automatisch bis zur Freigrenze.

Request-Felder

Minimal-Beispiel

{"ausbildungstyp": "hochschule", "bei_eltern": false, "alter": 22, "elterneinkommen_netto": 3200}

POST /v1/hebesaetze/bulk

Bulk-Lookup für bis zu 1.000 AGS pro Request. Nicht gefundene AGS landen im Feld nicht_gefunden statt den ganzen Request zu kippen.

Request-Felder

Minimal-Beispiel

{"ags_liste": ["05315000", "09162000", "11000000"]}

POST /v1/szenario/jobwechsel

Aggregiert Brutto-Netto alt und neu, Abfindung mit Fünftelregel, ALG I-Anspruch und Progressionsvorbehalt. Statt vier Requests einer.

Request-Felder

Beispiel

{"altes_brutto_monat": 4500, "neues_brutto_monat": 5200, "abfindung": 25000, "arbeitslos_monate": 3}

POST /v1/szenario/familie

Basiselterngeld, ElterngeldPlus, Kindergeld-Simulation und eine Empfehlung zur Steuerklassenkombination. Alles in einem Call für die Zeit vor der Geburt.

Request-Felder

Beispiel

{"nettoeinkommen_monat": 2500, "brutto_monat": 3800, "partner_brutto_monat": 5500, "geschwisterbonus": true}

POST /v1/szenario/immobilie

Grunderwerbsteuer, Jahres-Grundsteuer und Kaufnebenkosten in einem Call. Die Grundsteuer wird modellabhängig aus den mitgeschickten Feldern berechnet — fehlen welche, kennzeichnet das input_echo.

Request-Felder

Beispiel

{"kaufpreis": 450000, "bundesland": "Bayern", "grundstuecksflaeche_m2": 500, "wohnflaeche_m2": 140, "hebesatz_grundsteuer_prozent": 535}

POST /v1/szenario/freelance-start

Einzelunternehmer gegen GmbH: ESt + Soli + KiSt + GewSt mit §35-Anrechnung auf der einen Seite, KSt + Soli + GewSt + KapESt bei Ausschüttung auf der anderen. Die Response nennt den Netto-Gewinner.

Request-Felder

Beispiel

{"gewinn_jahr": 120000, "hebesatz_gewerbesteuer": 475, "bundesland": "Nordrhein-Westfalen"}

POST /v1/verlustverrechnung

3-Topf-Verlustverrechnung nach §20 Abs. 6 EStG (Aktien-Topf, Sonstiger Topf) und §23 EStG (Krypto/PrivVG-Topf). Berücksichtigt Sparer-Pauschbetrag (1.000/2.000 EUR), §23-Freigrenze (1.000 EUR), Verlustvorträge aus Vorjahren und das BVerfG-Verfahren 2 BvL 3/21 zur Aktien-Topf-Beschränkung. Liefert eine Schätzung der Steuer-Ersparnis im Vergleich zu einer naiven Berechnung ohne Verluste.

Request-Felder

Beispiel

{"aktien_verluste_ytd": "3000", "sonstige_gewinne_ytd": "5000",
 "sonstige_verluste_ytd": "2000",
 "krypto_verluste_ytd": "1500", "krypto_gewinne_ytd": "800"}

Response-Felder (Auszug)

POST /v1/vorabpauschale

Vorabpauschale für thesaurierende ETF/Fonds nach §18 InvStG für ein volles Kalenderjahr. Basisertrag = Fondswert_Jahresanfang × Basiszins × 0,70, abzüglich Ausschuettungen, gedeckelt auf die Wertsteigerung im Kalenderjahr. Teilfreistellung nach §20 InvStG je Fondstyp. Basiszins-Reihe 2018–2026 hinterlegt (BMF-Schreiben jährlich Anfang Januar). Sonderfälle (negativer Basiszins, Verlustjahr, Ausschuettungen ≥ Basisertrag) werden mit keine_vap_grund markiert.

Request-Felder

Beispiel

{"fondswert_jahresanfang": "10000", "fondswert_jahresende": "11000",
 "fondstyp": "aktien_51", "jahr": 2026}

Response-Felder (Auszug)

POST /v1/vorabpauschale/portfolio

Multi-Fonds-Vorabpauschale für einen Anleger. Berechnet die Vorabpauschale nach §18 InvStG für bis zu 1.000 Fonds in einem Aufruf. Optimiert für Robo-Advisor-Use-Cases (n Kunden × m Fonds × jährlich Anfang Januar). Per-Item-Error-Isolation: Schlägt ein Item fehl (z.B. Lib-Validierungsfehler), werden andere dennoch berechnet. Antwortet mit data.items[i].success als Pro-Item-Status plus aggregiertem data.summe_steuerpflichtig über alle erfolgreichen Items. Top-level success=True bedeutet ledigich, dass das Request well-formed war (keine 422). Performance-Limit: 1.000 Items <2 s Pure-Python-Decimal-Math.

Request-Felder

Beispiel

{"items": [
  {"fondswert_jahresanfang": "10000", "fondswert_jahresende": "11000", "fondstyp": "aktien_51"},
  {"fondswert_jahresanfang": "5000",  "fondswert_jahresende": "5300",  "ausschuettungen": "50", "fondstyp": "misch_25"}
]}

POST /v1/brutto-netto/batch

Bis zu 1.000 Mitarbeiter-Brutto-Netto-Berechnungen in einem Aufruf. Killer-Use-Case für Lohn-/HR-SaaS mit pro-Monat-Slip-Generation. Per-Item-Error-Isolation analog Vorabpauschale-Portfolio. Performance-verifiziert <3 s für 1.000 Items.

Request-Felder

Beispiel

{"items": [
  {"bruttolohn": "3500", "steuerklasse": 1},
  {"bruttolohn": "5500", "steuerklasse": 3, "kinder": 2}
]}

POST /v1/minijob/batch

Minijob/Midijob-Status für bis zu 1.000 Mitarbeiter in einem Aufruf. Per-Item-Error-Isolation analog brutto-netto/batch. Für Pflege-/Gastro-/Reinigungs-SaaS.

Beispiel

{"items": [
  {"bruttogehalt": "538"},
  {"bruttogehalt": "1500", "kinderlos_ueber_23": true}
]}

POST /v1/midijob/batch

Midijob-Berechnung im Übergangsbereich (603,01 - 2.000 EUR) für bis zu 1.000 Mitarbeiter. Per-Item-Error-Isolation analog brutto-netto/batch: Items außerhalb des Bereichs werden als per-row-Error markiert.

Beispiel

{"items": [
  {"brutto_monat": 1000, "steuerklasse": 1},
  {"brutto_monat": 1800, "steuerklasse": 5, "bundesland": "Bayern", "kirchensteuer": true}
]}

POST /v1/arbeitgeber-kosten/batch

AG-Gesamtkosten (KV/PV/RV/AV + U1/U2/Insolvenzgeld + BG-Beitrag) für bis zu 1.000 Mitarbeiter in einem Aufruf. Konfigurierbare Umlagesätze pro Item. Per-Item-Error-Isolation analog brutto-netto/batch.

Beispiel

{"items": [
  {"brutto_monat": 5000},
  {"brutto_monat": 8500, "bundesland": "Bayern", "u1_satz": "2.5"}
]}

POST /v1/lohnkosten-netto/batch

Lohnkosten-zu-Netto-Umkehrrechnung (AG-Gesamtkostenbudget → Brutto → Netto) für bis zu 1.000 Mitarbeiter. Items mit unerreichbarem Ziel werden als per-row-Error markiert. Per-Item-Error-Isolation analog brutto-netto/batch.

Beispiel

{"items": [
  {"lohnkosten_ziel": 6000, "steuerklasse": 1},
  {"lohnkosten_ziel": 8000, "steuerklasse": 3, "kinder": 2, "bundesland": "Bayern"}
]}

POST /v1/aktivrente/batch

Aktivrente-Steuerersparnis (Aktivrentegesetz seit 01.01.2026, 2.000 EUR/Monat steuerfrei) für bis zu 1.000 Rentner in einem Aufruf. HR-/Lohnbüro-Use-Case: „Welche Mitarbeiter ab 63 profitieren wie stark?“. Per-Item-Error-Isolation analog brutto-netto/batch. Kein anderer DACH-API-Anbieter im RapidAPI-Marketplace deckt Aktivrente bisher ab.

Beispiel

{"items": [
  {"brutto_rente_monat": 1800, "zusatzeinkommen_monat": 1500},
  {"brutto_rente_monat": 2200, "zusatzeinkommen_monat": 2500,
   "kirchensteuer": true, "bundesland": "Bayern"}
]}

POST /v1/kapitalertragsteuer

Berechnet die abgeltende Quellensteuer auf eine bereits BEREINIGTE Bemessungsgrundlage (nach Sparer-Pauschbetrag und Verlustverrechnung): KapESt 25 % nach §43a EStG, Solidaritätszuschlag 5,5 % auf KapESt (kein Phase-Out beim Quellenabzug, §4 SolzG), Kirchensteuer 8 % (BY/BW) bzw. 9 % (übrige). Bei aktiver Kirchensteuer greift die §51a Abs. 2c EStG-Spezialformel KapESt = e / (4 + k) — viele Marketplace-Wettbewerber ignorieren das und liefern die nominellen 25 % statt der korrekten ~24,51 % (BY/BW) bzw. ~24,45 % (Rest).

Request-Felder

Beispiel

{"bemessungsgrundlage": "10000", "bundesland": "Bayern",
 "kirchensteuerpflichtig": true}

Response-Felder (Auszug)

GET /v1/werte/current

Aggregiert alle deutschen Lohn- und Steuerwerte als 1-Call-JSON-Snapshot zum heutigen Tag: Sozialversicherung (BBG, Sätze AN+AG), ESt-Tarif (5 Zonen + Grundfreibetrag + Soli + KapESt + Sparer-Pauschbetrag), Lohnsteuer-PAP-Hilfsbeträge (ANP/SAP/EFA/KFB/VSP/StKl5-W1-W3), Pfändungsfreigrenzen-Bekanntmachung §850c ZPO, Firmenwagen-1%-Regelung incl. BEV-Stichtag-Logik 70k/100k, alle 16 Bundesländer mit KiSt-Satz + GrESt-Satz + PV-Sachsen-Sonder, Vorabpauschale-Basiszins-Reihe seit 2018 (BMF jährlich), Sachbezugswerte SvEV (Verpflegung 333 EUR/Mo, Unterkunft 282 EUR/Mo, Wohnung pro m²), Inland-Reisekostenpauschalen §9 Abs. 4a EStG (Volltag 28 EUR, Halbtag 14 EUR, Übernachtung 20 EUR, Mahlzeitenkürzung 5,60/11,20/11,20).

Caching

Im Gegensatz zu allen anderen Endpoints (Cache-Control: no-store) liefert das Werte-Bundle Cache-Control: public, max-age=86400 — CDN-cachebar für 24 h. Zusätzlich ETag + Last-Modified-Header. Schick den ETag mit If-None-Match bei deinem Daily-Cron zurück und du bekommst 304 Not Modified ohne Body, falls sich nichts geändert hat.

Beispiel

curl -H "X-RapidAPI-Proxy-Secret: $SECRET" \
     https://api.rechner-hub.de/v1/werte/current

Response-Struktur (Auszug)

{
  "data": {
    "stichtag": "2026-05-10", "jahr": 2026,
    "sozialversicherung": { "bbg_kv_pv_monat": "5812.5", "kv_an_basis": "7.3", ... },
    "einkommensteuer": { "grundfreibetrag": "12348", "kapest_satz": "25", ... },
    "lohnsteuer_pap": { "arbeitnehmer_pauschbetrag": "...", ... },
    "pfaendung": { "gueltig_ab": "2025-07-01", "grundfreibetrag_monat": "...", ... },
    "firmenwagen": { "bev_listenpreis_grenze": "100000",
                     "bev_grenze_alt": "70000", "bev_stichtag": "2025-07-01", ... },
    "bundeslaender": [ {"name": "Bayern", "kuerzel": "BY",
                        "kirchensteuersatz_prozent": "8", ... }, ... 16 ],
    "basiszins_reihe": [ {"jahr": 2018, "basiszins_prozent": "0.87", ...}, ... ],
    "sachbezug": { "verpflegung": {...}, "unterkunft": {...}, "wohnung": {...} },
    "reisekosten_inland": { "verpflegung": {...}, "uebernachtung": {...},
                             "mahlzeitenkuerzung": {...} },
    "quellen": [ {"name": "...", "url": "...", "abrufdatum": "..."}, ... ]
  }
}

GET /v1/werte/{stichtag}

Wie /v1/werte/current, aber für einen frei gewählten Stichtag im ISO-Format YYYY-MM-DD. Stichtag-Jahr muss in den unterstützten Jahren liegen (2024-2026). Pfändungs-Bekanntmachung wird per Stichtag korrekt aufgelöst, alle anderen Werte stammen aus dem Stichtag-Jahr.

Beispiel

curl -H "X-RapidAPI-Proxy-Secret: $SECRET" \
     https://api.rechner-hub.de/v1/werte/2024-09-01

Für Stichtage in 2024 wird die alte Pfändungs-Bekanntmachung (gültig 2024-07-01..2025-06-30) aufgelöst und die ESt-Tarif-Werte aus 2024.

GET /v1/basiszins/current

Aktuell gültiger Basiszinssatz nach §247 BGB. Der Satz wird halbjährlich (1.1./1.7.) per Bundesbank-Pressemitteilung angepasst und ist die Grundlage für Verzugszins-Berechnungen (§288 BGB) sowie viele Vertrags- und AGB-Klauseln. Cache-Control: public, max-age=86400 (24h CDN-cachebar).

Beispiel

curl -H "X-RapidAPI-Proxy-Secret: $SECRET" \
     https://api.rechner-hub.de/v1/basiszins/current

Response (Auszug)

{"data": {
  "stichtag": "2026-01-01",
  "satz_prozent": "1.27",
  "naechste_anpassung_erwartet": "2026-07-01",
  "rechtsgrundlage": "§247 Abs. 1 Satz 1 BGB"
}}

GET /v1/basiszins/series

Komplette Reihe aller Basiszinssätze seit Einführung 2002-01-01 (49+ Einträge halbjährlich, sortiert alt -> neu). Praktisch für Excel-/CSV-Export oder Audit-Trails von Verzugszins-Berechnungen über lange Zeiträume. Cache-Control: public, max-age=86400.

Response (Auszug)

{"data": {
  "items": [
    {"stichtag": "2002-01-01", "satz_prozent": "2.57"},
    ...
    {"stichtag": "2026-01-01", "satz_prozent": "1.27"}
  ],
  "erster_eintrag": "2002-01-01",
  "letzter_eintrag": "2026-01-01",
  "anzahl_eintraege": 49
}}

GET /v1/basiszins/{stichtag}

Liefert den am Stichtag gültigen Basiszinssatz (jüngster Eintrag ≤ Stichtag). Stichtag im Format YYYY-MM-DD, mind. 2002-01-01. Auflösung des Geltungsbeginns geschieht automatisch (z.B. 2025-08-15 -> gueltig_ab 2025-07-01).

Beispiel

curl -H "X-RapidAPI-Proxy-Secret: $SECRET" \
     https://api.rechner-hub.de/v1/basiszins/2025-08-15

Response (Auszug)

{"data": {
  "stichtag_requested": "2025-08-15",
  "gueltig_ab": "2025-07-01",
  "satz_prozent": "1.27",
  "rechtsgrundlage": "§247 Abs. 1 Satz 1 BGB"
}}

POST /v1/verzugszins

Berechnet Verzugszinsen §288 BGB auf eine überfällige Forderung. Verzugsbeginn = Tag NACH Fälligkeit (§286 Abs. 1 BGB), Endpunkt = Zahlungsdatum (zählt MIT). actual/365. Bei langem Verzugszeitraum mit Halbjahres-Wechsel des Basiszinses (§247 BGB) wird pro Halbjahres-Fenster mit dem dort gültigen Satz gerechnet — keine Mischzinsen, keine Tagesdurchschnittsbildung. Aufschlag: +5 Pkt (b2c) oder +9 Pkt (b2b). Optional 40-EUR-Schadenersatzpauschale §288 Abs. 5 BGB (B2B-only, separat ausgewiesen).

Request-Felder

Beispiel: B2B mit Halbjahres-Wechsel

{"forderung_eur": "10000",
 "faelligkeit": "2024-12-15", "zahlungsdatum": "2025-08-15",
 "geschaeftsverkehr": "b2b", "pauschale_anwenden": true}

Response (Auszug)

{"data": {
  "verzugsbeginn": "2024-12-16",
  "verzugstage_gesamt": 243,
  "posten": [
    {"von": "2024-12-16", "bis": "2024-12-31", "tage": 16,
     "basiszins_prozent": "3.37", "gesamtzins_prozent": "12.37",
     "zinsen_eur": "54.22"},
    {"von": "2025-01-01", "bis": "2025-06-30", "tage": 181,
     "basiszins_prozent": "2.27", "gesamtzins_prozent": "11.27",
     "zinsen_eur": "558.87"},
    {"von": "2025-07-01", "bis": "2025-08-15", "tage": 46,
     "basiszins_prozent": "1.27", "gesamtzins_prozent": "10.27",
     "zinsen_eur": "129.43"}
  ],
  "verzugszinsen_summe_eur": "742.52",
  "pauschale_288_abs_5_eur": "40",
  "rechtsgrundlage": "§288 Abs. 2 BGB (Geschäftsverkehr): Basiszinssatz + 9 Prozentpunkte"
}}

POST /v1/szenario/aktien-etf

Bündel-Endpoint: aggregiert Vorabpauschale (§18 InvStG) + 3-Topf-Verlustverrechnung (§20 Abs. 6 EStG + §23 EStG) + echte Kapitalertragsteuer mit bundeslandspezifischer Kirchensteuer (§51a Abs. 2c EStG-Spezialformel) in einem Aufruf. Liefert die tatsächliche Steuerlast statt der überschlägigen 26,375-%-Pauschale, die viele Online-Rechner ansetzen. Effektivsatz inkl. KiSt: 27,82 % (BY/BW, 8 % KiSt) bzw. 27,99 % (übrige Länder, 9 % KiSt).

Request-Felder (alle optional, Default 0 oder Konstante)

Beispiel

{"aktien_gewinne_ytd": "5000", "aktien_verluste_ytd": "1500",
 "sonstige_gewinne_ytd": "2000",
 "bundesland": "Bayern", "kirchenmitglied": true}

Response-Felder (Auszug)

Bundesland-Werte

Muss exakt so geschrieben sein — Groß-/Kleinschreibung und Bindestriche zählen:

GET /v1/hebesaetze-historie

Hebesatz-Zeitreihe einer einzelnen Gemeinde über mehrere Stichjahre (Gewerbesteuer + Grundsteuer A/B + Einwohnerzahl). Pflicht-Query ags (8-stelliger Amtlicher Gemeindeschlüssel). Quelle: Destatis 71231-03-01-5. Cache-Control: public, max-age=86400.

Beispiel

curl -H "X-RapidAPI-Proxy-Secret: $SECRET" \
     "https://api.rechner-hub.de/v1/hebesaetze-historie?ags=05315000"

Response (Auszug)

{"data": {"ags": "05315000", "eintraege": [
  {"stand": 2022, "hebesatz_gewerbesteuer": 475, "hebesatz_grundst_a": 165,
   "hebesatz_grundst_b": 515, "einwohner": 1081167, "quelle": "destatis_stat_bericht"},
  {"stand": 2024, "hebesatz_gewerbesteuer": 475, ...}]}}

GET /v1/hebesaetze-aggregat

Gewogener Durchschnitts-Gewerbesteuer-Hebesatz je Bundesland als 10-Jahres-Reihe (2016–2025, Gemeinden ab 20.000 Einwohnern). Optionale Query-Filter bundesland (exakter Name) und jahr (2016–2025). Quelle: VdF/DIHK Realsteuer-Hebesätze. Cache-Control: public, max-age=86400.

Beispiel

curl -H "X-RapidAPI-Proxy-Secret: $SECRET" \
     "https://api.rechner-hub.de/v1/hebesaetze-aggregat?bundesland=Nordrhein-Westfalen&jahr=2025"

Response (Auszug)

{"data": {"eintraege": [
  {"jahr": 2025, "bundesland": "Nordrhein-Westfalen", "hebesatz_gewerbesteuer_avg": 474}],
  "quelle": "VdF Daten und Fakten Realsteuer-Hebesaetze (Stand 01.09.2025)"}}

GET /v1/gkv-zusatzbeitrag

Aktueller GKV-Zusatzbeitrag einer Krankenkasse in Prozent. Lookup über ik (9-stellige IK-Nummer oder Slug wie techniker-krankenkasse) oder name (Fuzzy-Substring, liefert ersten Treffer). Optional stichtag für historische Snapshots. Quelle: GKV-Spitzenverband. Cache-Control: public, max-age=86400.

Beispiel

curl -H "X-RapidAPI-Proxy-Secret: $SECRET" \
     "https://api.rechner-hub.de/v1/gkv-zusatzbeitrag?name=Techniker"

Response (Auszug)

{"data": {"ik_nummer": "techniker-krankenkasse", "name": "Techniker Krankenkasse",
  "zusatzbeitrag_prozent": "2.69", "snapshot_datum": "2026-05-25",
  "quelle_url": "gkv:current:2026-05-25"}}

Verwandt: /durchschnitt (Jahres-Mittel über alle Kassen), /historie (Zeitreihe einer Kasse).

GET /v1/gkv-zusatzbeitrag/durchschnitt

Mittelwert des Zusatzbeitrags über alle erfassten Kassen-Snapshots eines Berichtsjahres (Coverage 2021–2026). Pflicht-Query jahr (2015–2030). Hinweis: dies ist der erhobene Snapshot-Mittelwert, nicht der amtliche durchschnittliche Zusatzbeitrag nach §242a SGB V.

Response (Auszug)

{"data": {"jahr": 2026, "durchschnitt_prozent": "3.4311", "snapshot_count": 225}}

GET /v1/gkv-zusatzbeitrag/historie

Vollständige Zeitreihe der Zusatzbeitrags-Snapshots einer Kasse (Wayback-CDX-Snapshots + aktueller Stand). Pflicht-Query ik (IK-Nummer oder Slug).

Response (Auszug)

{"data": {"ik_nummer": "techniker-krankenkasse", "name": "Techniker Krankenkasse",
  "eintraege": [
    {"snapshot_datum": "2023-01-07", "zusatzbeitrag_prozent": "1.2",
     "quelle_url": "wayback:20230107010159"}, ...]}}

GET /v1/gkv-kassen

Verzeichnis aller 92 aktiven GKV-Kassen mit IK-Nummer/Slug, Name, Kassen-Typ (AOK, Ersatzkasse, BKK, IKK …) und Geltungsbereich (bundesweit ja/nein). Keine Parameter — der Stammdaten-Feed für ein Kassen-Dropdown.

Response (Auszug)

{"data": {"kassen": [
  {"ik_nummer": "aok-baden-wuerttemberg", "name": "AOK Baden-Württemberg",
   "kassen_typ": "AOK", "bundesweit": false, "aktiv": true}, ...]}}

GET /v1/gkv-ik-verzeichnis

Offizielles IK-Nummern-Verzeichnis (~1.083 Einträge) aus den ITSG/BAS-Kostenträgerdateien — eine Kasse kann mehrere regionale IK-Nummern haben. Lookup über ik (exakt, 9-stellig) oder name (Fuzzy-Substring).

Response (Auszug)

{"data": {"eintraege": [
  {"ik_nummer": "100177504", "name": "TECHNIKER KRANKENKASSE",
   "kassen_typ_code": "Ersatzkasse", "quelle_file": "EK05Q226.ke0.txt"}, ...]}}

GET /v1/eeg-verguetung

Anzulegender Wert (feste Einspeisevergütung) für eine Solar-Dachanlage nach EEG. Pflicht-Query inbetriebnahme (YYYY-MM-DD), anlagentyp (pv_dach_wohngebaeude | pv_dach_sonstige), kwp. Optional einspeisung (teil|voll, Default teil) und stichtag (Restlaufzeit). Quelle: Bundesnetzagentur. Cache-Control: public, max-age=86400.

Beispiel

curl -H "X-RapidAPI-Proxy-Secret: $SECRET" \
     "https://api.rechner-hub.de/v1/eeg-verguetung?inbetriebnahme=2024-04-15&anlagentyp=pv_dach_wohngebaeude&kwp=9.8&einspeisung=teil"

Response (Auszug)

{"data": {"verguetung_ct_per_kwh": "8.514", "novelle": "EEG 2023",
  "verguetungsdauer_jahre": 20, "gueltig_bis": "2044-12-31",
  "restlaufzeit_monate": 223, "quelle_url": "bundesnetzagentur:feb24-jul24"}}

Verwandt: /historie (Zeitreihe je kWp-Klasse), /v1/eeg-novellen.

GET /v1/eeg-verguetung/historie

Komplette Zeitreihe der EEG-Tarife für eine kWp-Klasse + Einspeise-Art über alle Novellen-Fenster. Pflicht-Query kwp. Optional anlagentyp, einspeisung.

Response (Auszug)

{"data": {"anlagentyp": "pv_dach_wohngebaeude", "einspeisung": "teil",
  "eintraege": [
    {"novelle": "EEG 2012", "inbetriebnahme_von": "2012-04-01",
     "verguetung_ct_per_kwh": "19.5", "gueltig_bis": "2032-12-31"}, ...]}}

GET /v1/eeg-novellen

Liste aller in der API hinterlegten EEG-Novellen (EEG 2009 bis heute) mit Gültigkeitszeitraum und BGBl-Referenz. Keine Parameter — nützlich, um die richtige Novelle zu einem Inbetriebnahme-Datum zuzuordnen.

Response (Auszug)

{"data": {"novellen": [
  {"id": 1, "name": "EEG 2009", "gueltig_ab": "2009-01-01",
   "gueltig_bis": "2012-03-31", "bgbl_referenz": "BGBl. I 2008 S. 2074"}, ...]}}

GET /v1/mietstufe/{ags}

Wohngeld-Mietenstufe I–VII (1–7) einer Gemeinde nach der Anlage zur Wohngeldverordnung (gültig ab 01.01.2023). Pfad-Parameter ags (8-stellig). Gemeinden ohne eigene Listung erben die Kreis-Stufe; sonst 404. Ideal zum Vorbelegen des Mietstufe-Felds im Wohngeld-Rechner.

Response

{"data": {"ags": "09162000", "mietstufe": 7, "mietstufe_roman": "VII"},
 "meta": {"tax_year": 2026}}

GET /v1/einkommen/{ags}

Zeitreihe des Gesamtbetrags der Einkünfte je Steuerpflichtigem (§ 2 Abs. 3 EStG) einer Gemeinde aus der Lohn- und Einkommensteuerstatistik (Destatis 73111). Wichtig: das ist nicht das Brutto-/Durchschnittsgehalt, und die Statistik hat 3–4 Jahre Datenlag. Pfad-Parameter ags (8-stellig).

Response (Auszug)

{"data": {"ags": "09162000", "eintraege": [
  {"jahr": 2021, "steuerpflichtige": 820100,
   "gesamtbetrag_einkuenfte_tsd": 46000000,
   "je_steuerpflichtigem_eur": 56090, "quelle": "destatis_73111_01_01"}, ...]}}

GET /v1/schulden/{ags}

Zeitreihe der Schulden des kommunalen Kernhaushalts (Destatis 71327, Stichtag 31.12.) auf Kreisebene inkl. Schuld je Einwohner. Der Kreis wird aus den ersten 5 Stellen der Gemeinde-AGS abgeleitet, da die Quelle Gemeinde-Schulden fast nur über Verbände führt. Acht kreisfreie Städte ohne Meldung liefern 404.

Response (Auszug)

{"data": {"ags": "09162000", "kreis_ags": "09162", "kreis_einwohner": 1512491,
  "eintraege": [
    {"jahr": 2024, "schulden_insgesamt_eur": 3200000000,
     "schulden_je_einwohner_eur": 2116, "quelle": "destatis_71327_z01"}]}}