{"openapi":"3.1.0","info":{"title":"Brutto-Netto-Kalkulator API","version":"1.0.0","description":"Offene, kostenlose API für Brutto-Netto-Berechnungen (Rechenstand 2026). Ohne Gewähr. Limit: 60 Anfragen pro Minute und IP."},"servers":[{"url":"https://brutto-netto-kalkulator.de"}],"paths":{"/api/v1/berechnen":{"post":{"summary":"Brutto zu Netto","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"bruttoMonat":{"type":"number","minimum":0,"maximum":1000000},"bruttoJahr":{"type":"number","minimum":0,"maximum":12000000},"steuerklasse":{"default":1,"type":"integer","minimum":1,"maximum":6},"kinder":{"default":0,"type":"integer","minimum":0,"maximum":15},"kirchensteuer":{"default":false,"type":"boolean"},"bundesland":{"default":"NW","type":"string","enum":["BW","BY","BE","BB","HB","HH","HE","MV","NI","NW","RP","SL","SN","ST","SH","TH"]},"alter":{"default":35,"type":"integer","minimum":16,"maximum":80},"krankenversicherung":{"default":"gesetzlich","type":"string","enum":["gesetzlich","privat"]},"zusatzbeitrag":{"default":2.9,"type":"number","minimum":0,"maximum":8},"pkvKvMonat":{"default":0,"type":"number","minimum":0,"maximum":5000},"pkvPvMonat":{"default":0,"type":"number","minimum":0,"maximum":1000},"freibetragJahr":{"default":0,"type":"number","minimum":0,"maximum":200000},"bavMonat":{"default":0,"type":"number","minimum":0,"maximum":10000},"vlMonat":{"default":0,"type":"number","minimum":0,"maximum":1000},"sachbezugMonat":{"default":0,"type":"number","minimum":0,"maximum":10000},"faktor":{"type":"number","minimum":0.5,"maximum":1},"aktivrente":{"default":false,"type":"boolean"},"minijobRvBefreit":{"default":false,"type":"boolean"},"vergleich":{"default":false,"type":"boolean"}}}}}},"responses":{"200":{"description":"Ergebnis"},"400":{"description":"Kein gültiges JSON"},"422":{"description":"Ungültige Eingabe"},"429":{"description":"Zu viele Anfragen (60 pro Minute)"}}},"get":{"summary":"Brutto zu Netto (Query-Parameter)","responses":{"200":{"description":"Ergebnis"}}}},"/api/v1/netto-zu-brutto":{"post":{"summary":"Netto zu Brutto","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"steuerklasse":{"default":1,"type":"integer","minimum":1,"maximum":6},"kinder":{"default":0,"type":"integer","minimum":0,"maximum":15},"kirchensteuer":{"default":false,"type":"boolean"},"bundesland":{"default":"NW","type":"string","enum":["BW","BY","BE","BB","HB","HH","HE","MV","NI","NW","RP","SL","SN","ST","SH","TH"]},"alter":{"default":35,"type":"integer","minimum":16,"maximum":80},"krankenversicherung":{"default":"gesetzlich","type":"string","enum":["gesetzlich","privat"]},"zusatzbeitrag":{"default":2.9,"type":"number","minimum":0,"maximum":8},"pkvKvMonat":{"default":0,"type":"number","minimum":0,"maximum":5000},"pkvPvMonat":{"default":0,"type":"number","minimum":0,"maximum":1000},"freibetragJahr":{"default":0,"type":"number","minimum":0,"maximum":200000},"bavMonat":{"default":0,"type":"number","minimum":0,"maximum":10000},"vlMonat":{"default":0,"type":"number","minimum":0,"maximum":1000},"sachbezugMonat":{"default":0,"type":"number","minimum":0,"maximum":10000},"faktor":{"type":"number","minimum":0.5,"maximum":1},"aktivrente":{"default":false,"type":"boolean"},"minijobRvBefreit":{"default":false,"type":"boolean"},"vergleich":{"default":false,"type":"boolean"},"nettoMonat":{"type":"number","minimum":0,"maximum":1000000},"nettoJahr":{"type":"number","minimum":0,"maximum":12000000}}}}}},"responses":{"200":{"description":"Ergebnis"},"400":{"description":"Kein gültiges JSON"},"422":{"description":"Ungültige Eingabe"},"429":{"description":"Zu viele Anfragen (60 pro Minute)"}}},"get":{"summary":"Netto zu Brutto (Query-Parameter)","responses":{"200":{"description":"Ergebnis"}}}},"/api/v1/steuerklassen":{"post":{"summary":"Steuerklassenkombinationen und Faktor","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"kinder":{"default":0,"type":"integer","minimum":0,"maximum":15},"kirchensteuer":{"default":false,"type":"boolean"},"bundesland":{"default":"NW","type":"string","enum":["BW","BY","BE","BB","HB","HH","HE","MV","NI","NW","RP","SL","SN","ST","SH","TH"]},"krankenversicherung":{"default":"gesetzlich","type":"string","enum":["gesetzlich","privat"]},"zusatzbeitrag":{"default":2.9,"type":"number","minimum":0,"maximum":8},"pkvKvMonat":{"default":0,"type":"number","minimum":0,"maximum":5000},"pkvPvMonat":{"default":0,"type":"number","minimum":0,"maximum":1000},"freibetragJahr":{"default":0,"type":"number","minimum":0,"maximum":200000},"bavMonat":{"default":0,"type":"number","minimum":0,"maximum":10000},"vlMonat":{"default":0,"type":"number","minimum":0,"maximum":1000},"sachbezugMonat":{"default":0,"type":"number","minimum":0,"maximum":10000},"aktivrente":{"default":false,"type":"boolean"},"minijobRvBefreit":{"default":false,"type":"boolean"},"vergleich":{"default":false,"type":"boolean"},"bruttoA":{"type":"number","minimum":0,"maximum":1000000},"bruttoB":{"type":"number","minimum":0,"maximum":1000000},"alterA":{"default":35,"type":"integer","minimum":16,"maximum":80},"alterB":{"default":35,"type":"integer","minimum":16,"maximum":80}},"required":["bruttoA","bruttoB"]}}}},"responses":{"200":{"description":"Ergebnis"},"400":{"description":"Kein gültiges JSON"},"422":{"description":"Ungültige Eingabe"},"429":{"description":"Zu viele Anfragen (60 pro Minute)"}}},"get":{"summary":"Steuerklassenkombinationen und Faktor (Query-Parameter)","responses":{"200":{"description":"Ergebnis"}}}},"/api/v1/bonus":{"post":{"summary":"Netto von Bonus und Sonderzahlung","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"bruttoMonat":{"type":"number","minimum":0,"maximum":1000000},"steuerklasse":{"default":1,"type":"integer","minimum":1,"maximum":6},"kinder":{"default":0,"type":"integer","minimum":0,"maximum":15},"kirchensteuer":{"default":false,"type":"boolean"},"bundesland":{"default":"NW","type":"string","enum":["BW","BY","BE","BB","HB","HH","HE","MV","NI","NW","RP","SL","SN","ST","SH","TH"]},"alter":{"default":35,"type":"integer","minimum":16,"maximum":80},"krankenversicherung":{"default":"gesetzlich","type":"string","enum":["gesetzlich","privat"]},"zusatzbeitrag":{"default":2.9,"type":"number","minimum":0,"maximum":8},"pkvKvMonat":{"default":0,"type":"number","minimum":0,"maximum":5000},"pkvPvMonat":{"default":0,"type":"number","minimum":0,"maximum":1000},"freibetragJahr":{"default":0,"type":"number","minimum":0,"maximum":200000},"bavMonat":{"default":0,"type":"number","minimum":0,"maximum":10000},"vlMonat":{"default":0,"type":"number","minimum":0,"maximum":1000},"sachbezugMonat":{"default":0,"type":"number","minimum":0,"maximum":10000},"faktor":{"type":"number","minimum":0.5,"maximum":1},"aktivrente":{"default":false,"type":"boolean"},"minijobRvBefreit":{"default":false,"type":"boolean"},"vergleich":{"default":false,"type":"boolean"},"bonus":{"type":"number","minimum":0,"maximum":5000000}},"required":["bruttoMonat","bonus"]}}}},"responses":{"200":{"description":"Ergebnis"},"400":{"description":"Kein gültiges JSON"},"422":{"description":"Ungültige Eingabe"},"429":{"description":"Zu viele Anfragen (60 pro Minute)"}}},"get":{"summary":"Netto von Bonus und Sonderzahlung (Query-Parameter)","responses":{"200":{"description":"Ergebnis"}}}},"/api/v1/dienstwagen":{"post":{"summary":"Geldwerter Vorteil Dienstwagen","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"bruttoMonat":{"type":"number","minimum":0,"maximum":1000000},"steuerklasse":{"default":1,"type":"integer","minimum":1,"maximum":6},"kinder":{"default":0,"type":"integer","minimum":0,"maximum":15},"kirchensteuer":{"default":false,"type":"boolean"},"bundesland":{"default":"NW","type":"string","enum":["BW","BY","BE","BB","HB","HH","HE","MV","NI","NW","RP","SL","SN","ST","SH","TH"]},"alter":{"default":35,"type":"integer","minimum":16,"maximum":80},"krankenversicherung":{"default":"gesetzlich","type":"string","enum":["gesetzlich","privat"]},"zusatzbeitrag":{"default":2.9,"type":"number","minimum":0,"maximum":8},"pkvKvMonat":{"default":0,"type":"number","minimum":0,"maximum":5000},"pkvPvMonat":{"default":0,"type":"number","minimum":0,"maximum":1000},"freibetragJahr":{"default":0,"type":"number","minimum":0,"maximum":200000},"bavMonat":{"default":0,"type":"number","minimum":0,"maximum":10000},"vlMonat":{"default":0,"type":"number","minimum":0,"maximum":1000},"faktor":{"type":"number","minimum":0.5,"maximum":1},"aktivrente":{"default":false,"type":"boolean"},"minijobRvBefreit":{"default":false,"type":"boolean"},"vergleich":{"default":false,"type":"boolean"},"bruttolistenpreis":{"type":"number","minimum":0,"maximum":500000},"antrieb":{"default":"verbrenner","type":"string","enum":["verbrenner","hybrid","elektro"]},"entfernungKm":{"default":0,"type":"number","minimum":0,"maximum":500},"zuzahlungMonat":{"default":0,"type":"number","minimum":0,"maximum":5000},"anschaffungsJahr":{"default":2026,"type":"integer","minimum":2000,"maximum":2040},"anschaffungsMonat":{"default":1,"type":"integer","minimum":1,"maximum":12},"hybridReichweiteKm":{"type":"number","minimum":0,"maximum":1000},"hybridCo2Unter50":{"default":false,"type":"boolean"}},"required":["bruttoMonat","bruttolistenpreis"]}}}},"responses":{"200":{"description":"Ergebnis"},"400":{"description":"Kein gültiges JSON"},"422":{"description":"Ungültige Eingabe"},"429":{"description":"Zu viele Anfragen (60 pro Minute)"}}},"get":{"summary":"Geldwerter Vorteil Dienstwagen (Query-Parameter)","responses":{"200":{"description":"Ergebnis"}}}},"/api/v1/gehaltserhoehung":{"post":{"summary":"Netto-Wirkung einer Gehaltserhöhung","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"bruttoMonat":{"type":"number","minimum":0,"maximum":1000000},"steuerklasse":{"default":1,"type":"integer","minimum":1,"maximum":6},"kinder":{"default":0,"type":"integer","minimum":0,"maximum":15},"kirchensteuer":{"default":false,"type":"boolean"},"bundesland":{"default":"NW","type":"string","enum":["BW","BY","BE","BB","HB","HH","HE","MV","NI","NW","RP","SL","SN","ST","SH","TH"]},"alter":{"default":35,"type":"integer","minimum":16,"maximum":80},"krankenversicherung":{"default":"gesetzlich","type":"string","enum":["gesetzlich","privat"]},"zusatzbeitrag":{"default":2.9,"type":"number","minimum":0,"maximum":8},"pkvKvMonat":{"default":0,"type":"number","minimum":0,"maximum":5000},"pkvPvMonat":{"default":0,"type":"number","minimum":0,"maximum":1000},"freibetragJahr":{"default":0,"type":"number","minimum":0,"maximum":200000},"bavMonat":{"default":0,"type":"number","minimum":0,"maximum":10000},"vlMonat":{"default":0,"type":"number","minimum":0,"maximum":1000},"sachbezugMonat":{"default":0,"type":"number","minimum":0,"maximum":10000},"faktor":{"type":"number","minimum":0.5,"maximum":1},"aktivrente":{"default":false,"type":"boolean"},"minijobRvBefreit":{"default":false,"type":"boolean"},"vergleich":{"default":false,"type":"boolean"},"erhoehungProzent":{"type":"number","minimum":-50,"maximum":500},"erhoehungEuro":{"type":"number","minimum":-100000,"maximum":1000000}},"required":["bruttoMonat"]}}}},"responses":{"200":{"description":"Ergebnis"},"400":{"description":"Kein gültiges JSON"},"422":{"description":"Ungültige Eingabe"},"429":{"description":"Zu viele Anfragen (60 pro Minute)"}}},"get":{"summary":"Netto-Wirkung einer Gehaltserhöhung (Query-Parameter)","responses":{"200":{"description":"Ergebnis"}}}},"/api/v1/baukasten":{"post":{"summary":"Gehaltsbaukasten: Dienstwagen, Sachbezüge, Bonus mit Vorauszahlung kombiniert","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"bruttoMonat":{"type":"number","minimum":0,"maximum":1000000},"steuerklasse":{"default":1,"type":"integer","minimum":1,"maximum":6},"kinder":{"default":0,"type":"integer","minimum":0,"maximum":15},"kirchensteuer":{"default":false,"type":"boolean"},"bundesland":{"default":"NW","type":"string","enum":["BW","BY","BE","BB","HB","HH","HE","MV","NI","NW","RP","SL","SN","ST","SH","TH"]},"alter":{"default":35,"type":"integer","minimum":16,"maximum":80},"krankenversicherung":{"default":"gesetzlich","type":"string","enum":["gesetzlich","privat"]},"zusatzbeitrag":{"default":2.9,"type":"number","minimum":0,"maximum":8},"pkvKvMonat":{"default":0,"type":"number","minimum":0,"maximum":5000},"pkvPvMonat":{"default":0,"type":"number","minimum":0,"maximum":1000},"freibetragJahr":{"default":0,"type":"number","minimum":0,"maximum":200000},"bavMonat":{"default":0,"type":"number","minimum":0,"maximum":10000},"vlMonat":{"default":0,"type":"number","minimum":0,"maximum":1000},"sachbezugMonat":{"default":0,"type":"number","minimum":0,"maximum":10000},"faktor":{"type":"number","minimum":0.5,"maximum":1},"aktivrente":{"default":false,"type":"boolean"},"minijobRvBefreit":{"default":false,"type":"boolean"},"vergleich":{"default":false,"type":"boolean"},"dienstwagen":{"oneOf":[{"type":"object","properties":{"methode":{"type":"string","const":"einProzent"},"bruttolistenpreis":{"type":"number","minimum":0,"maximum":500000},"antrieb":{"default":"verbrenner","type":"string","enum":["verbrenner","hybrid","elektro"]},"entfernungKm":{"default":0,"type":"number","minimum":0,"maximum":500},"zuzahlungMonat":{"default":0,"type":"number","minimum":0,"maximum":5000},"anschaffungsJahr":{"default":2026,"type":"integer","minimum":2000,"maximum":2040},"anschaffungsMonat":{"default":1,"type":"integer","minimum":1,"maximum":12},"hybridReichweiteKm":{"type":"number","minimum":0,"maximum":1000},"hybridCo2Unter50":{"default":false,"type":"boolean"}},"required":["methode","bruttolistenpreis"]},{"type":"object","properties":{"methode":{"type":"string","const":"fahrtenbuch"},"gesamtkostenJahr":{"type":"number","minimum":0,"maximum":500000},"privatanteilProzent":{"type":"number","minimum":0,"maximum":100},"zuzahlungMonat":{"default":0,"type":"number","minimum":0,"maximum":5000}},"required":["methode","gesamtkostenJahr","privatanteilProzent"]},{"type":"object","properties":{"methode":{"type":"string","const":"pauschal"},"vorteilMonat":{"type":"number","minimum":0,"maximum":10000},"zuzahlungMonat":{"default":0,"type":"number","minimum":0,"maximum":5000}},"required":["methode","vorteilMonat"]}]},"bonus":{"type":"object","properties":{"brutto":{"type":"number","minimum":0,"maximum":5000000},"vorauszahlung":{"default":0,"type":"number","minimum":0,"maximum":5000000}},"required":["brutto"]},"gutscheinMonat":{"type":"number","minimum":0,"maximum":10000},"jobticketMonat":{"type":"number","minimum":0,"maximum":10000},"dienstrad":{"type":"object","properties":{"bruttolistenpreis":{"type":"number","minimum":0,"maximum":50000},"rateMonat":{"type":"number","minimum":0,"maximum":2000},"art":{"default":"umwandlung","type":"string","enum":["zusaetzlich","umwandlung"]}},"required":["bruttolistenpreis","rateMonat"]},"sonstigerVorteilMonat":{"type":"number","minimum":0,"maximum":10000},"steuerfreiMonat":{"type":"number","minimum":0,"maximum":10000}},"required":["bruttoMonat"]}}}},"responses":{"200":{"description":"Ergebnis"},"400":{"description":"Kein gültiges JSON"},"422":{"description":"Ungültige Eingabe"},"429":{"description":"Zu viele Anfragen (60 pro Minute)"}}}},"/api/v1/parameter":{"get":{"summary":"Rechengrößen 2026","responses":{"200":{"description":"Parameter"}}}},"/api/v1/health":{"get":{"summary":"Statusprüfung","responses":{"200":{"description":"ok"}}}}}}