{"name":"firma.de GmbH-Steuern-API","apiVersion":1,"description":"Rechnet für eine GmbH oder UG vom Gewinn vor Steuern aus, was an Steuern anfällt und was dir als Gesellschafter bleibt, mit derselben Engine wie der GmbH-Steuerrechner von firma.de. In der GmbH: Körperschaftsteuer nach § 23 KStG (15 % bis 2027, danach ein Punkt weniger je Jahr bis 10 % ab 2032), Solidaritätszuschlag, Gewerbesteuer ohne Freibetrag mit dem Hebesatz der Gemeinde (Mindesthebesatz 200 %, ab 2027 280 %), Verlustvortrag mit Mindestbesteuerung und die Rücklage der UG. Bei dir: die Ausschüttung mit Abgeltungsteuer, Günstigerprüfung und Teileinkünfteverfahren nebeneinander, gerechnet mit dem Einkommensteuertarif nach § 32a EStG, dazu Solidaritätszuschlag, Kirchensteuer und für freiwillig gesetzlich Versicherte Kranken- und Pflegeversicherung; oder deine Holding-GmbH als Empfängerin nach § 8b KStG. Dazu der Rechenweg, die Senkung der Körperschaftsteuer bis 2032, ein Vergleich mit einem Einzelunternehmen mit demselben Gewinn, Vorauszahlungen mit Terminen, Hinweise zum Fall und ein Link, der die Berechnung im Rechner öffnet. Der Gewinn zählt nach dem Geschäftsführergehalt; das Gehalt selbst rechnet die API nicht. Jahre 2025, 2026, 2027; 2027 rechnet die Einkommensteuer des Gesellschafters 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 und keine Firma. 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, Cent werden gerundet. Sie dürfen deutsch geschrieben sein: 100000, 100.000, 100.000 €, 100k, 1,2 Mio. Der Gewinn darf negativ sein (Verlust). Hebesatz, Ausschüttung und Anteil in Prozent: 490, 50 %, 33,33. 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: ug, holding, privat, verheiratet, teileinkünfteverfahren, gesetzlich … 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 filing oder otherIncome bei recipient=holding, land ohne church=true). 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-03","openapi":"https://www.firma.de/api/gmbh-steuern/openapi.json","calculator":"https://www.firma.de/gmbh-steuern/","calculatorLink":"calculatorUrl öffnet die Berechnung im GmbH-Steuerrechner, etwa https://www.firma.de/gmbh-steuern/#f=2026&g=250000&hs=490&a=50. Nach dem # stehen f (das Jahr) und die Angaben, die vom Standard abweichen, mit kurzen Namen (g Gewinn, rf Rechtsform g oder u, hs Hebesatz, a Ausschüttung in Prozent, an Anteil in Prozent, e Empfänger p oder h, m Methode a, ab, gp oder te, v Veranlagung e oder z, zve übriges zu versteuerndes Einkommen, ks Kirchensteuer, kv Krankenversicherung o oder g, vv Verlustvortrag …). 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, Rechenweg, Methodenvergleich und Vergleich mit dem Einzelunternehmen.","example":"md","type":"enum","values":["json","md"]},"values":{"description":"Nur POST: die Felder als Objekt, statt sie flach zu schreiben.","example":"{ \"profit\": 100000 }","type":"object"}},"fields":[{"name":"year","type":"integer","default":2026,"description":"Steuerjahr: 2025, 2026, 2027. Standard 2026. 2027 rechnet die Einkommensteuer des Gesellschafters mit dem Regierungsentwurf, der noch nicht beschlossen ist.","example":"2026","values":["2025","2026","2027"],"aliases":["jahr","steuerjahr","veranlagungsjahr"]},{"name":"legalForm","type":"enum","default":"gmbh","description":"Rechtsform: gmbh (Standard) oder ug (Unternehmergesellschaft haftungsbeschränkt; ein Viertel des Jahresüberschusses abzüglich Verlustvortrag geht in die gesetzliche Rücklage nach § 5a Abs. 3 GmbHG und wird nicht ausgeschüttet).","example":"ug","values":["gmbh","ug"],"aliases":["rechtsform"]},{"name":"profit","type":"number","default":100000,"description":"Gewinn der GmbH vor Körperschaft- und Gewerbesteuer im Jahr in ganzen Euro, nach dem Gehalt des Geschäftsführers; negativ bei Verlust, -5.000.000 bis 50.000.000. Standard 100.000.","example":"100000","min":-5000000,"max":50000000,"aliases":["gewinn","gewinnvorsteuern"]},{"name":"hebesatz","type":"integer","default":400,"description":"Hebesatz der Gemeinde für die Gewerbesteuer in Prozent, ganze Zahl von 200 bis 1000, etwa 490 für München. Unter dem Mindesthebesatz des Jahres (2025: 200 %, 2026: 200 %, 2027: 280 %) rechnet die API mit dem Mindesthebesatz und sagt es in checks. Standard 400.","example":"490","min":200,"max":1000},{"name":"payout","type":"integer","default":100,"description":"Ausschüttungsquote: wie viel Prozent des ausschüttbaren Jahresüberschusses an die Gesellschafter gehen, ganze Zahl von 0 bis 100; der Rest bleibt in der GmbH. Standard 100.","example":"50","min":0,"max":100,"aliases":["ausschuettung","ausschuettungsquote"]},{"name":"share","type":"number","default":100,"description":"Dein Anteil an der GmbH in Prozent, 1 bis 100, bis zu zwei Nachkommastellen (33,33). Bestimmt deinen Teil der Ausschüttung, ob das Teileinkünfteverfahren möglich ist (ab 25 %, mit beruflicher Tätigkeit und maßgeblichem unternehmerischem Einfluss, etwa als Geschäftsführer, ab 1 %) und bei einer Holding, ob § 8b KStG greift (ab 10 %, für die Gewerbesteuer ab 15 %). Standard 100.","example":"60","min":1,"max":100,"aliases":["anteil","beteiligung"]},{"name":"recipient","type":"enum","default":"person","description":"Wer die Anteile hält: person (du privat; Standard) oder holding (deine Holding-GmbH; ab 10 % Anteil 95 % der Ausschüttung körperschaftsteuerfrei nach § 8b KStG, ab 15 % auch gewerbesteuerfrei; gerechnet mit demselben Hebesatz).","example":"holding","values":["person","holding"],"aliases":["empfaenger"]},{"name":"method","type":"enum","default":"auto","description":"Nur bei recipient=person: Besteuerung der Ausschüttung. auto (die günstigste der möglichen; Standard), abgeltung (Abgeltungsteuer 25 %), guenstiger (Günstigerprüfung: dein Tarif, wenn er niedriger ist, sonst Abgeltungsteuer) oder teileinkuenfte (Teileinkünfteverfahren auf Antrag: 60 % zum Tarif; nicht möglich, rechnet die API die günstigste und sagt es in checks).","example":"teileinkuenfte","values":["auto","abgeltung","guenstiger","teileinkuenfte"],"onlyWhen":"recipient=person","aliases":["methode","verfahren","besteuerung"]},{"name":"filing","type":"enum","default":"single","description":"Nur bei recipient=person: Veranlagung, single (Einzelveranlagung, Grundtabelle; Standard) oder joint (Zusammenveranlagung, Splittingtabelle, doppelter Sparer-Pauschbetrag).","example":"joint","values":["single","joint"],"onlyWhen":"recipient=person","aliases":["veranlagung","familienstand"]},{"name":"otherIncome","type":"number","default":0,"description":"Nur bei recipient=person: dein übriges zu versteuerndes Einkommen im Jahr ohne die Ausschüttung in ganzen Euro, etwa aus deinem Geschäftsführergehalt nach allen Abzügen; bei joint das gemeinsame. Ein zu versteuerndes Einkommen, keine Einnahmen, 0 bis 5.000.000. Standard 0.","example":"60000","min":0,"max":5000000,"onlyWhen":"recipient=person","aliases":["zve","uebrigeszve","einkommen"]},{"name":"church","type":"boolean","default":false,"description":"Nur bei recipient=person: kirchensteuerpflichtig (bei joint beide). Standard false.","example":"true","onlyWhen":"recipient=person","aliases":["kirchensteuer","kirche"]},{"name":"health","type":"enum","default":"other","description":"Nur bei recipient=person: Krankenversicherung. other (privat versichert oder pflichtversichert über eine Anstellung, keine Beiträge auf die Ausschüttung; Standard) oder gkv (freiwillig gesetzlich versichert: Kranken- und Pflegeversicherung auch auf die Ausschüttung, bis zur Beitragsbemessungsgrenze).","example":"gkv","values":["other","gkv"],"onlyWhen":"recipient=person","aliases":["krankenversicherung"]},{"name":"childless","type":"boolean","default":true,"description":"Nur bei recipient=person und health=gkv: ohne Kinder, mit dem Zuschlag zur Pflegeversicherung. Standard true.","example":"false","onlyWhen":"recipient=person und health=gkv","aliases":["kinderlos"]},{"name":"lossCarryforward","type":"number","default":0,"description":"Verlustvortrag aus Vorjahren in ganzen Euro, ein Betrag für Körperschaft- und Gewerbesteuer; über 1.000.000 € Gewinn nur teilweise verrechenbar (Mindestbesteuerung). Mindert vereinfacht auch den ausschüttbaren Betrag. Standard 0.","example":"200000","min":0,"max":50000000,"aliases":["verlustvortrag"]},{"name":"saverAllowance","type":"boolean","default":true,"description":"Nur bei recipient=person: der Sparer-Pauschbetrag (1.000 €, bei joint 2.000 €) ist noch frei. Die GmbH behält trotzdem auf die ganze Ausschüttung Kapitalertragsteuer ein; der Pauschbetrag wirkt erst mit der Steuererklärung, nicht beim Teileinkünfteverfahren. Standard true.","example":"false","onlyWhen":"recipient=person","aliases":["sparerpauschbetrag"]},{"name":"activeInCompany","type":"boolean","default":true,"description":"Nur bei recipient=person: du arbeitest für die GmbH und hast dadurch maßgeblichen unternehmerischen Einfluss, etwa als Geschäftsführer; dann ist das Teileinkünfteverfahren schon ab 1 % Anteil möglich, sonst ab 25 %. Standard true.","example":"false","onlyWhen":"recipient=person","aliases":["geschaeftsfuehrer","mitarbeit"]},{"name":"land","type":"land","default":null,"description":"Nur bei recipient=person und 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":"recipient=person und church=true","aliases":["bundesland"]}],"examples":{"gmbh":{"description":"GmbH mit 100.000 € Gewinn bei 400 % Hebesatz, alles an dich ausgeschüttet, mit der günstigsten Besteuerung, 2026.","url":"https://www.firma.de/api/gmbh-steuern/?year=2026&profit=100000&hebesatz=400"},"ug":{"description":"UG in Köln (Hebesatz 475 %) mit 80.000 € Gewinn, die Hälfte wird ausgeschüttet, du hältst 60 % und bist verheiratet.","url":"https://www.firma.de/api/gmbh-steuern/?legalForm=ug&profit=80000&hebesatz=475&payout=50&share=60&filing=joint"},"holding":{"description":"GmbH in München (Hebesatz 490 %) mit 250.000 € Gewinn, die Ausschüttung geht an deine Holding-GmbH, als Markdown.","url":"https://www.firma.de/api/gmbh-steuern/?profit=250000&hebesatz=490&recipient=holding&format=md"}},"post":{"contentType":"application/json","description":"POST mit JSON: die Felder flach wie bei GET oder unter values, etwa { \"year\": 2026, \"values\": { \"profit\": 150000, \"hebesatz\": 450, \"share\": 50 } }. 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":{"profit":150000,"hebesatz":450,"share":50,"filing":"joint","otherIncome":60000,"church":true,"land":"by","health":"gkv"},"format":"json"}},"answer":{"ok":"true bei jedem Ergebnis.","apiVersion":"1. Ändert sich nur mit einer neuen Adresse.","year":"Das gerechnete Jahr.","draft":"true, wenn der Einkommensteuertarif des Jahres auf einem Entwurf beruht, der noch nicht beschlossen ist (2027); draftOf nennt sein Datum, fallbackYear das Jahr, dessen Tarif sonst weiter gilt. Körperschaftsteuer und Mindesthebesatz sind beschlossen; die Beitragswerte der Kranken- und Pflegeversicherung beruhen teils auch auf Entwürfen.","input":"Die Angaben, mit denen gerechnet wurde, in ganzen Euro und Prozent; 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 filing bei recipient=holding). input lässt sich unverändert zurückschicken.","totals":"Summen in Euro: gmbhTaxes (Körperschaftsteuer, Solidaritätszuschlag und Gewerbesteuer der GmbH), dividendTaxes (Steuern auf deine Ausschüttung nach der Steuererklärung, bei recipient=holding die Steuern der Holding), health (Kranken- und Pflegeversicherung auf die Ausschüttung abzüglich ihrer Steuerentlastung), net (was dir privat bleibt, bei recipient=holding was in der Holding bleibt) und retainedShare (dein Anteil an dem, was in der GmbH bleibt).","rates":"Sätze in Prozent: gmbh (Steuern der GmbH in Prozent des Gewinns), distributed (GmbH- und Ausschüttungssteuern in Prozent des Gewinns hinter deiner Ausschüttung; 0 ohne Ausschüttung), total (dein Anteil an den Steuern der GmbH plus die Steuern auf deine Ausschüttung, in Prozent deines Anteils am Gewinn) und totalWithHealth (dasselbe mit Kranken- und Pflegeversicherung).","corporate":"Die Steuern der GmbH in Euro: profit, kst (base nach Verlustvortrag, rate in Prozent, tax auf volle Euro abgerundet, soli), gewst (hebesatz wie angewandt, mindestens der Mindesthebesatz des Jahres; ertrag auf volle 100 € abgerundet, ohne Freibetrag; messbetrag; tax), lossCarryforward (je kst und gewst: before, limit, used, remaining, capped und share der Mindestbesteuerung in Prozent), total und rate in Prozent des Gewinns.","payout":"Der Weg zur Ausschüttung in Euro: surplus (Jahresüberschuss nach Steuern), lossOffset (Verlustvortrag, vereinfacht wie bei den Steuern), reserve (Rücklage der UG), distributable, payout und share in Prozent, distribution (an alle Gesellschafter), dividend (deine Ausschüttung), others (an die übrigen Gesellschafter) und retained (bleibt in der GmbH, die Rücklage eingeschlossen).","shareholder":"Nur bei recipient=person, sonst null: dividend, requested (die gewählte Methode) und method (die angewandte), cheapest (die günstigste), tevEligible (Teileinkünfteverfahren möglich), withheld (Kapitalertragsteuer, Solidaritätszuschlag und Kirchensteuer, die die GmbH auf die ganze Ausschüttung einbehält), methods (abgeltung, guenstiger und teileinkuenfte, letzteres null, wenn nicht möglich; je mit zvE, taxable, est, soli, church, total, healthRelief, effective und refund: Erstattung, negativ eine Nachzahlung mit der Steuererklärung), health (null außer bei health=gkv: base, rates, kv, extra, pv, total, capped) und net.","holding":"Nur bei recipient=holding, sonst null: dividend, regime (full ab 15 % Anteil, addBack von 10 bis unter 15 %, none unter 10 %), kstBase, kst, soli, gewstBase, hebesatz, gewst, total, withheld (Kapitalertragsteuer mit Solidaritätszuschlag, die das Finanzamt der Holding anrechnet oder erstattet) und net (bleibt in der Holding).","prepayments":"Vorauszahlungen der GmbH: kst (Körperschaftsteuer mit Solidaritätszuschlag) und gewst, je mit applies (setzt das Finanzamt oder die Gemeinde sie fest), annual, quarterly und due (Termine, ein Wochenende auf den Montag danach verschoben); kapest: die Kapitalertragsteuer auf die Ausschüttung in Euro, fällig am Tag des Zuflusses (am im Beschluss bestimmten Auszahlungstag, sonst am Tag nach dem Beschluss).","outlook":"Die Steuern der GmbH für jedes Jahr 2025 bis 2032 bei diesem Gewinn und Hebesatz (angehoben auf den Mindesthebesatz des Jahres), ohne Verlustvortrag: year, kstRate, hebesatz, kst, soli, gewst, total und rate in Prozent des Gewinns.","comparison":"Derselbe Gewinn rechnerisch als gewerbliches Einzelunternehmen (einzelunternehmen: est, soli, church, gewst) und in der GmbH mit 100 % Anteil privat gehalten, einmal voll ausgeschüttet (full), einmal ganz in der GmbH behalten (retain: gmbhTaxes, dividendTaxes); je mit taxes (nach dem Steuervorteil der Beiträge), contributions (Kranken- und Pflegeversicherung bei health=gkv), privat (privat verfügbar) und company (bleibt in der GmbH). Ohne Kinder; bei recipient=holding mit den Standardwerten des Gesellschafters. Ohne Geschäftsführergehalt, Pensionszusage und die laufenden Kosten der GmbH. Bei Verlust und über 5 Mio. € Gewinn null.","split":"Wohin der Gewinn geht, in Euro: kst, kstSoli, gewst, dividendTax, dividendSoli, church, dividendGewst, health, net, others (an die übrigen Gesellschafter) und retained (bleibt in der GmbH). Zusammen der Gewinn, bei Verlust alles 0.","steps":"Der Rechenweg in Zeilen: id, label, group (gmbh für die Steuern der GmbH, payout für den Weg zur Ausschüttung, shareholder für deine Steuern oder die der Holding), 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, cta, wenn ein Steuerberater weiterhilft, und link, wenn eine andere Seite weiterhilft.","notIncluded":"Was die Berechnung nicht enthält, etwa Geschäftsführergehalt, Hinzurechnungen und Umsatzsteuer.","calculatorUrl":"Öffnet die Berechnung im GmbH-Steuerrechner von firma.de, mit Rechenweg, Grafik, Methodenvergleich und Vorauszahlungen, zum Teilen und Drucken.","checkedOn":"Datum, zu dem Steuersätze, Tarif und Beitragswerte zuletzt gegen ihre Quellen geprüft wurden.","disclaimer":"Unverbindliche Schätzung, allgemeine Steuerinformation, keine Steuerberatung.","sources":"Gesetzestexte und Quellen hinter der Berechnung: Körperschaftsteuer, Gewerbesteuer, Solidaritätszuschlag, Abgeltungsteuer, Tarif, Beitragswerte und die Normen der Zeilen."},"disclaimer":"Allgemeine Steuerinformation, keine Steuerberatung. Unverbindliche Schätzung, Stand 3. November 2026."}