{"name":"firma.de Einkommensteuer-API","apiVersion":1,"description":"Rechnet für Selbstständige und Gründer vom Gewinn aus alles, was im Jahr an Steuern anfällt, mit derselben Engine wie der Einkommensteuer-Rechner von firma.de: Einkommensteuer nach dem Tarif des § 32a EStG (Grund- oder Splittingtabelle), Solidaritätszuschlag, Kirchensteuer und für Gewerbetreibende die Gewerbesteuer mit ihrer Anrechnung nach § 35 EStG. Dazu Kranken- und Pflegeversicherung als freiwillig gesetzlich Versicherte, die Günstigerprüfung zwischen Kindergeld und Kinderfreibeträgen, der Rechenweg bis zum zu versteuernden Einkommen, Durchschnitts- und Grenzsteuersatz, die Vorauszahlungen mit Terminen, was du monatlich zurücklegen kannst, Hinweise zum Fall und ein Link, der die Berechnung im Rechner öffnet. Jahre 2025, 2026, 2027; 2027 rechnet mit dem Regierungsentwurf, der noch nicht beschlossen ist. Eine unverbindliche Schätzung, allgemeine Steuerinformation, keine Steuerberatung. Kostenlos, ohne Schlüssel.","privacy":"Die API rechnet auf dem Server und speichert selbst weder Eingaben noch Ergebnisse. Sie fragt nur Beträge und Eckdaten ab, keine Namen. Antworten auf GET-Aufrufe hält das CDN bis zu einem Tag unter ihrer Adresse zwischen, samt den Parametern darin; Antworten auf POST nie. Die Parameter einer GET-Adresse können außerdem wie jede Adresse in Zugriffsprotokollen von Hosting, Proxys, Browsern und Agenten landen; willst du beides vermeiden, nimm POST.","units":"Beträge in ganzen Euro im Jahr (außer pkvMonthly, im Monat), Cent werden gerundet. Sie dürfen deutsch geschrieben sein: 60000, 60.000, 60.000 €, 60k, 1,2 Mio. Gewinn und Einkünfte dürfen negativ sein (Verlust). Sätze in Prozent: 2,9 oder 2.9. Bundesländer als Kürzel (by), Name (Bayern) oder Kurzform (NRW). Ja und nein als true/false, 1/0 oder ja/nein. Auswahlwerte gehen auch auf Deutsch: zusammen, verheiratet, freiberufler, gewerbe, gesetzlich, privat … Die Antwort nennt Beträge in Euro mit zwei Nachkommastellen und Sätze in Prozent.","statuses":"200 mit dem Ergebnis. 400 mit problems je Feld: ein Wert ist ungültig, ein Feld gibt es nicht, oder der Rechner liest es bei den übrigen Angaben nicht (etwa partnerIncome ohne filing=joint oder hebesatz bei einer freiberuflichen Tätigkeit). Tracking-Parameter wie utm_source zählen nicht. 413 über 20000 Bytes (Body oder GET-Adresse), 429 bei mehr als 120 Aufrufen pro Minute, 500, wenn sich die Eingabe nicht verarbeiten ließ.","checkedOn":"2026-11-02","openapi":"https://www.firma.de/api/einkommensteuer/openapi.json","calculator":"https://www.firma.de/einkommensteuer/","calculatorLink":"calculatorUrl öffnet die Berechnung im Einkommensteuer-Rechner, etwa https://www.firma.de/einkommensteuer/#f=2026&t=g&g=100000&hs=490. Nach dem # stehen f (das Jahr) und die Angaben, die vom Standard abweichen, mit kurzen Namen (g Gewinn, t Tätigkeit f oder g, v Veranlagung e oder z, ki Kinder, ks Kirchensteuer, hs Hebesatz …). Der Teil nach # erreicht unseren Server nicht; der Rechner liest ihn im Browser.","parameters":{"format":{"description":"json (Standard) oder md: das Ergebnis als Markdown mit Tabellen und Rechenweg.","example":"md","type":"enum","values":["json","md"]},"values":{"description":"Nur POST: die Felder als Objekt, statt sie flach zu schreiben.","example":"{ \"profit\": 60000 }","type":"object"}},"fields":[{"name":"year","type":"integer","default":2026,"description":"Steuerjahr: 2025, 2026, 2027. Standard 2026. 2027 rechnet mit dem Regierungsentwurf, der noch nicht beschlossen ist.","example":"2026","values":["2025","2026","2027"],"aliases":["jahr","steuerjahr","veranlagungsjahr"]},{"name":"filing","type":"enum","default":"single","description":"Veranlagung: single (Einzelveranlagung, Grundtabelle; Standard) oder joint (Zusammenveranlagung von Ehe- oder eingetragenen Lebenspartnern, Splittingtabelle).","example":"joint","values":["single","joint"],"aliases":["veranlagung","familienstand"]},{"name":"activity","type":"enum","default":"freiberuflich","description":"Tätigkeit: freiberuflich (§ 18 EStG, keine Gewerbesteuer; Standard) oder gewerblich (§ 15 EStG, mit Gewerbesteuer und ihrer Anrechnung nach § 35 EStG).","example":"gewerblich","values":["freiberuflich","gewerblich"],"aliases":["taetigkeit"]},{"name":"profit","type":"number","default":60000,"description":"Gewinn aus der Selbstständigkeit im Jahr in ganzen Euro (Einnahmen minus Betriebsausgaben), vor Gewerbesteuer; negativ bei Verlust. Standard 60.000.","example":"60000","min":-1000000,"max":5000000,"aliases":["gewinn"]},{"name":"otherIncome","type":"number","default":0,"description":"Weitere eigene Einkünfte im Jahr nach Werbungskosten, etwa Arbeitslohn oder Vermietung, in ganzen Euro; darf negativ sein. Bei health=gkv zählen positive Einkünfte auch für die Beitragsbemessung, ein Verlust mindert sie nicht. Einbehaltene Lohnsteuer rechnet die API nicht an. Standard 0.","example":"12000","min":-1000000,"max":5000000,"aliases":["weitereeinkuenfte","andereeinkuenfte"]},{"name":"partnerIncome","type":"number","default":0,"description":"Nur bei filing=joint: Einkünfte des Partners im Jahr nach Werbungskosten in ganzen Euro; darf negativ sein. Standard 0.","example":"45000","min":-1000000,"max":5000000,"onlyWhen":"filing=joint","aliases":["partnereinkuenfte"]},{"name":"partnerDeductions","type":"number","default":0,"description":"Nur bei filing=joint: abziehbare Vorsorgeaufwendungen des Partners im Jahr in ganzen Euro (Renten- und Pflegebeitrag, Krankenbeitrag ohne den Anteil für das Krankengeld); abgezogen wie angegeben. Standard 0.","example":"9000","min":0,"max":5000000,"onlyWhen":"filing=joint","aliases":["partnervorsorge"]},{"name":"health","type":"enum","default":"gkv","description":"Krankenversicherung: gkv (freiwillig gesetzlich versichert; Standard), pkv (privat, mit pkvMonthly) oder none (keine Beiträge hier, etwa familienversichert oder über eine Anstellung).","example":"pkv","values":["gkv","pkv","none"],"aliases":["krankenversicherung"]},{"name":"sickPay","type":"boolean","default":false,"description":"Nur bei health=gkv: mit Anspruch auf Krankengeld (allgemeiner Beitragssatz 14,6 % statt ermäßigt 14,0 %). Standard false.","example":"true","onlyWhen":"health=gkv","aliases":["krankengeld"]},{"name":"extraRate","type":"number","default":null,"description":"Nur bei health=gkv: Zusatzbeitrag deiner Kasse in Prozent, 0 bis 5. Ohne Angabe der durchschnittliche Zusatzbeitrag des Jahres (2026: 2,9 %).","example":"2,9","min":0,"max":5,"onlyWhen":"health=gkv","aliases":["zusatzbeitrag"]},{"name":"pkvMonthly","type":"number","default":600,"description":"Nur bei health=pkv: Beitrag für die Basisabsicherung samt Pflegeversicherung im Monat in ganzen Euro, laut Bescheinigung der Versicherung. Standard 600.","example":"650","min":0,"max":5000,"onlyWhen":"health=pkv","aliases":["pkvbeitrag"]},{"name":"pension","type":"number","default":0,"description":"Altersvorsorge im Jahr (gesetzliche Rentenversicherung, Versorgungswerk, Rürup) in ganzen Euro; abziehbar bis zum Höchstbetrag (2026: 30.826 €, bei filing=joint doppelt). Standard 0.","example":"6000","min":0,"max":5000000,"aliases":["altersvorsorge","rentenversicherung"]},{"name":"children","type":"integer","default":0,"description":"Kinder mit Kindergeld, 0 bis 10. Die Berechnung prüft je Kind, ob Kindergeld oder Kinderfreibeträge günstiger sind. Standard 0.","example":"2","min":0,"max":10,"aliases":["kinder"]},{"name":"singleParent","type":"boolean","default":false,"description":"Nur bei filing=single mit children ab 1: alleinerziehend, mit dem Entlastungsbetrag nach § 24b EStG. Standard false.","example":"true","onlyWhen":"filing=single und children ab 1","aliases":["alleinerziehend"]},{"name":"church","type":"boolean","default":false,"description":"Kirchensteuerpflichtig (bei filing=joint beide). Standard false.","example":"true","aliases":["kirchensteuer","kirche"]},{"name":"land","type":"land","default":null,"description":"Nur bei church=true: Bundesland für den Kirchensteuersatz, 8 % in Bayern und Baden-Württemberg, sonst 9 %; Kürzel wie by, Name wie Bayern oder NRW. Ohne Angabe 9 %.","example":"by","onlyWhen":"church=true","aliases":["bundesland"]},{"name":"hebesatz","type":"integer","default":400,"description":"Nur bei activity=gewerblich: Hebesatz der Gemeinde für die Gewerbesteuer in Prozent, ganze Zahl von 200 bis 1000, etwa 490 für München. Standard 400.","example":"490","min":200,"max":1000,"onlyWhen":"activity=gewerblich"},{"name":"otherDeductions","type":"number","default":0,"description":"Abziehbare Sonderausgaben im Jahr in ganzen Euro, etwa Spenden, gezahlte Kirchensteuer oder 80 % der Kinderbetreuungskosten; außergewöhnliche Belastungen nur mit dem Teil über der zumutbaren Belastung. Abgezogen wie angegeben, darunter zählt der Pauschbetrag (36 €, bei filing=joint doppelt). Standard 0.","example":"1200","min":0,"max":5000000,"aliases":["sonderausgaben"]}],"examples":{"freelancer":{"description":"Freiberufler mit 60.000 € Gewinn, ledig, gesetzlich versichert, 2026.","url":"https://www.firma.de/api/einkommensteuer/?year=2026&profit=60000"},"gewerbe":{"description":"Gewerbetreibender in München (Hebesatz 490 %) mit 100.000 € Gewinn: Gewerbesteuer und was § 35 EStG davon anrechnet.","url":"https://www.firma.de/api/einkommensteuer/?activity=gewerblich&profit=100000&hebesatz=490"},"couple":{"description":"Ehepaar mit zwei Kindern, Freiberuflerin mit 80.000 € Gewinn, Partner mit 45.000 € Einkünften, mit Kirchensteuer in Bayern, als Markdown.","url":"https://www.firma.de/api/einkommensteuer/?filing=joint&profit=80000&partnerIncome=45000&partnerDeductions=9000&children=2&church=true&land=by&format=md"}},"post":{"contentType":"application/json","description":"POST mit JSON: die Felder flach wie bei GET oder unter values, etwa { \"year\": 2026, \"values\": { \"profit\": 60000, \"filing\": \"joint\" } }. So passt auch input aus einer früheren Antwort: die Felder von input unverändert. Fehlende Felder und null behalten den Standard des Rechners. format geht auch hier, ebenso ?format=md in der Adresse.","example":{"year":2026,"values":{"activity":"gewerblich","profit":90000,"hebesatz":450,"health":"pkv","pkvMonthly":650,"pension":6000},"format":"json"}},"answer":{"ok":"true bei jedem Ergebnis.","apiVersion":"1. Ändert sich nur mit einer neuen Adresse.","year":"Das gerechnete Jahr.","draft":"true, wenn die Werte des Jahres auf einem Entwurf beruhen, der noch nicht beschlossen ist (2027); draftOf nennt sein Datum, fallbackYear das Jahr, dessen Tarif sonst weiter gilt.","input":"Die Angaben, mit denen gerechnet wurde, in ganzen Euro; was der Aufruf nicht angab, steht auf dem Standard des Rechners. null steht bei einem Feld, das der Rechner bei diesen Angaben nicht liest (etwa hebesatz bei freiberuflich), und bei extraRate für den durchschnittlichen Zusatzbeitrag. input lässt sich unverändert zurückschicken.","totals":"Summen in Euro: income (Summe der Einkünfte), taxes (Einkommensteuer, Solidaritätszuschlag, Kirchensteuer und Gewerbesteuer), contributions (Kranken-, Pflegeversicherung und Altersvorsorge, wie gezahlt), afterTaxes (income minus taxes) und afterAll (nach Steuern und Beiträgen).","tax":"Die Steuern in Euro: tariff (tarifliche Einkommensteuer auf zvE), gewstCredit (Anrechnung der Gewerbesteuer, § 35 EStG), kindergeldAddBack (hinzugerechnetes Kindergeld, wenn die Freibeträge günstiger sind), est (festzusetzende Einkommensteuer), soliBase und soli, churchBase, churchRate (0, 8 oder 9) und church, gewst (Gewerbesteuer) und total.","zvE":"Das zu versteuernde Einkommen in Euro, auf volle Euro abgerundet; zvESoli mit allen Kinderfreibeträgen, die Grundlage von Solidaritätszuschlag und Kirchensteuer.","income":"Die Einkünfte in Euro: profit, other, partner (nur bei filing=joint), sum, positive (Summe der positiven Einkünfte) und gewerblich (für § 35 EStG).","deductions":"Die Abzüge in Euro: entlastung (Alleinerziehende), gesamtbetrag, kv (Krankenversicherung, mit Krankengeld um 4 % gekürzt: kvCut), pv, pkv, partner, pension (Altersvorsorge bis pensionCap), vorsorge, sonderausgaben und einkommen.","children":"Die Günstigerprüfung (§ 31 EStG) je Kind: allowance (Kinderfreibetrag und Freibetrag für Betreuung, Erziehung, Ausbildung), kindergeld, saving (gesparte Einkommensteuer) und applied (Freibetrag abgezogen); dazu count, applied, allowance, kindergeldAddBack und kindergeldPaid (ausgezahltes Kindergeld im Jahr, in keiner Summe).","contributions":"Die Beiträge in Euro, wie gezahlt: health (gkv, pkv oder none), base und bound (Bemessungsgrundlage der gesetzlichen Versicherung, minimum oder ceiling, wenn sie begrenzt ist), rates (Sätze in Prozent), kv, extra (Zusatzbeitrag), pv, pkv, pension und total.","gewst":"Nur bei activity=gewerblich mit Gewinn, sonst null: hebesatz, ertrag (auf volle 100 € abgerundet), freibetrag, messbetrag, tax, credit (Anrechnung nach § 35 EStG), limits (factor: 4,0 × Messbetrag, actual: die Gewerbesteuer, ceiling: Ermäßigungshöchstbetrag), limitedBy und rest (was nicht angerechnet wird).","rates":"Sätze in Prozent: average (Steuern in Prozent der Summe der Einkünfte, nicht der Durchschnittssteuersatz auf das zu versteuernde Einkommen), averageAll (mit Beiträgen), marginal und marginalAll (Grenzbelastung: was mehr Gewinn an Steuern, mit Beiträgen, kostet, gemessen an 1.000 € mehr; je 100 € in ganzen Euro als marginalPer100 und marginalAllPer100) und marginalIncomeTax (Grenzsteuersatz des Tarifs auf das zu versteuernde Einkommen, mit Solidaritätszuschlag und Kirchensteuer, soweit sie anfallen).","prepayments":"Vorauszahlungen: est (Einkommensteuer ohne Kinderfreibeträge und Kindergeld nach § 37 Abs. 3 EStG, mit Solidaritätszuschlag und Kirchensteuer) und gewst (null ohne Gewerbesteuer), je mit applies (setzt das Finanzamt oder die Gemeinde sie fest), annual, quarterly und due (Termine, ein Wochenende auf den Montag danach verschoben); monthly mit taxes und withContributions: was du monatlich zurücklegen kannst.","split":"Wohin die Einkünfte gehen, in Euro: est, soli, church, gewst, health, care, pension und net (was übrig bleibt).","steps":"Der Rechenweg in Zeilen: id, label, group (income bis zum zvE, tax bis zur Einkommensteuer, total für alle Steuern), op (start, plus, minus, total), amount in Euro (bei plus und minus der Betrag ohne Vorzeichen), law mit lawUrl.","checks":"Hinweise zum Fall, „Prüfen“ (warn) vor „Gut zu wissen“ (info): title, text, law mit lawUrl und cta, wenn ein Steuerberater weiterhilft.","notIncluded":"Was die Berechnung nicht enthält, etwa Umsatzsteuer oder einbehaltene Lohnsteuer.","calculatorUrl":"Öffnet die Berechnung im Einkommensteuer-Rechner von firma.de, mit Rechenweg, Grafik und Vorauszahlungen, zum Teilen und Drucken.","checkedOn":"Datum, zu dem Tarif, Freibeträge und Beitragswerte zuletzt gegen ihre Quellen geprüft wurden.","disclaimer":"Unverbindliche Schätzung, allgemeine Steuerinformation, keine Steuerberatung.","sources":"Gesetzestexte und Quellen hinter der Berechnung: Tarif, Solidaritätszuschlag, Gewerbesteuer, Beitragswerte und die Normen der Zeilen."},"disclaimer":"Allgemeine Steuerinformation, keine Steuerberatung. Unverbindliche Schätzung, Stand 2. November 2026."}