Für Entwickler
Offene Brutto-Netto-API
Dieselbe Rechenlogik wie auf der Website, als JSON-Schnittstelle. Kostenlos und ohne Schlüssel, mit fairem Limit von 60 Anfragen pro Minute.
Beispiel
curl -X POST https://brutto-netto-kalkulator.de/api/v1/berechnen \
-H "Content-Type: application/json" \
-d '{"bruttoMonat": 3000, "steuerklasse": 1, "bundesland": "BY"}'Antwort (gekürzt): { "monat": { "netto": 2054.42, "lohnsteuer": 293.08, ... }, "jahr": { ... }, "stand": "2026" }
Die GET-Variante nimmt dieselben Felder als Query-Parameter: /api/v1/berechnen?bruttoMonat=3000&steuerklasse=1.
Endpunkte
| Methode | Pfad | Zweck |
|---|---|---|
| POST/GET | /api/v1/berechnen | Brutto → Netto (bruttoMonat oder bruttoJahr) |
| POST/GET | /api/v1/netto-zu-brutto | Netto → Brutto (nettoMonat oder nettoJahr) |
| POST/GET | /api/v1/steuerklassen | Kombinationen IV/IV, III/V, V/III und Faktor für zwei Einkommen |
| POST/GET | /api/v1/bonus | Netto von Bonus oder Sonderzahlung |
| POST/GET | /api/v1/dienstwagen | Geldwerter Vorteil und Netto-Kosten (mit Anschaffungsjahr) |
| POST | /api/v1/baukasten | Dienstwagen, Sachbezüge, Dienstrad und Bonus mit Vorauszahlung kombiniert |
| POST/GET | /api/v1/gehaltserhoehung | Netto-Wirkung einer Erhöhung |
| GET | /api/v1/parameter | Rechengrößen des Rechenstands |
| GET | /api/v1/health | Statusprüfung |
| GET | /api/v1/openapi.json | OpenAPI-3.1-Beschreibung |
Felder (Auswahl)
steuerklasse1–6,kinder0–15,kirchensteuertrue/false,bundesland(Kürzel wie BY, NW, SN),alterkrankenversicherunggesetzlich oder privat,zusatzbeitragin Prozent, bei PKVpkvKvMonatundpkvPvMonatfreibetragJahr,bavMonat,vlMonat,sachbezugMonat,faktor,aktivrentevergleich: true liefert zusätzlich das Netto aller sechs Steuerklassen
Fehler
Ungültige Eingaben liefern HTTP 422 mit fehler.details je Feld, kaputtes JSON 400, Überschreitung des Limits 429 mit Retry-After. Die vollständige Beschreibung liegt unter /api/v1/openapi.json.
Die API liefert Orientierungswerte ohne Gewähr. Bitte nenne bei Weiterverwendung die Quelle Brutto-Netto-Kalkulator.