# Öffentlicher Dienst Gehaltsrechner API (ÖD-Infoportal)
> Unabhängige Gehalts-, Besoldungs- und Netto-Berechnungs-API für den Öffentlichen Dienst in Deutschland (Beamte & Tarifbeschäftigte). Bereitgestellt von infos-oeffentlicher-dienst.de.

## API-Überblick
Die API liefert detaillierte und praxisnahe Brutto- und Netto-Berechnungen für:
- **Beamte (Bund & alle 16 Bundesländer):** Grundgehalt (Besoldungsordnungen A, B, C, R, W, Anwärter), bundeslandspezifische Familienzuschläge (z. B. Bayern Ortsklassen I–VII, NRW Mietenstufen), Stellenzulagen (Polizei, Justiz, Feuerwehr), Struktur- & Amtszulagen, jährliche Sonderzahlungen sowie Beihilfe-/PKV-Nettoabzüge.
- **Tarifbeschäftigte (TVöD, TV-L, TV-H, etc.):** Entgeltgruppen E1–E15, Erfahrungsstufen, Jahressonderzahlung, Zusatzversorgung (VBL/ZVK) und Sozialabgaben.

## Wichtiger Hinweis & Transparenz
Alle Berechnungen basieren auf den aktuell geltenden Besoldungstabellen, Tarifverträgen und dem offiziellen Programmablaufplan (PAP) der Finanzverwaltung für die Lohnsteuer. Aufgrund der vielfältigen Sonderregelungen und individuellen Konstellationen im Öffentlichen Dienst erfolgen alle Angaben sorgfältig recherchiert, jedoch ohne Gewähr auf Rechtsverbindlichkeit.

## Schnellzugriff für KI-Agenten & Entwickler
- **Vollständige Dokumentation (für LLMs):** https://infos-oeffentlicher-dienst.de/llms-full.txt
- **OpenAPI 3.1 Spezifikation:** https://infos-oeffentlicher-dienst.de/openapi.json
- **Interaktive Swagger UI:** https://infos-oeffentlicher-dienst.de/docs
- **Entwickler-Übersicht & API-Keys:** https://infos-oeffentlicher-dienst.de/api

## Zwei API-Modi

### 1. Agentic API (Discovery ➔ Zulagenauswahl ➔ Berechnung)
Für autonome KI-Agenten, die Zulagen kontextbezogen auswählen und Gehaltsberechnungen durchführen:
- `GET /api/v1/agent/options?dienstherr={dienstherr}&gruppe={gruppe}`: Liefert Stufen mit Grundgehalt, alle wählbaren Zulagen mit IDs, Beträgen und Beschreibungen, sowie Familienzuschlags-Regeln.
- `POST /api/v1/agent/calculate`: Vollständige Berechnung mit ausgewählten Zulagen-IDs (`selected_zulage_keys`), Familienstand, Kinderzahl und Steuerparametern.

### 2. Standard API (Direktberechnung für Jobbörsen & Apps)
Für schnelle Berechnungen aus Kerndaten ohne manuelle Zulagenauswahl:
- `POST /api/v1/calculate`: Berechnet Grundgehalt, Brutto, Netto und jährliche Sonderzahlung aus Gruppe, Stufe, Steuerklasse und Krankenversicherung.

## Authentifizierung
- Header: `Authorization: Bearer sk_...`
- Kostenlose Test-Keys (30 Requests/Monat) unter https://infos-oeffentlicher-dienst.de/api