{"openapi":"3.1.0","info":{"title":"Was kostet Bonn? – Finanzdaten","version":"1.0.0","description":"Statische, schreibgeschützte JSON-Dateien zum Haushalt der Stadt Bonn. Zugang per HTTP Basic Auth: Benutzername secret, Passwort password.\n\n- Jeder Wert hat Jahr, Status und Quelle. Diese drei Angaben bei jeder Antwort nennen.\n- Werte mit unterschiedlichem Status (Ist, Entwurf, Plan, Prognose) nie addieren. Vergleiche über Jahre nur mit gleichem Status oder ausdrücklich als Plan-Ist-Vergleich.\n- Ausnahme: Werte mit vergleichbar_mit_ist: false (Plan 2008–2024 aus dem Open-Data-Planarchiv in aufgaben) nie mit Ist oder Entwurf vergleichen, auch nicht als Plan-Ist-Vergleich.\n- Mehrere Planwerte für dasselbe Jahr unterscheiden sich im Feld planstand (urspruenglich, vorjahresansatz, fortgeschrieben, archiv) oder in der Quelle; Planjahre der mittelfristigen Finanzplanung tragen mittelfristig: true.\n- Ergebnisrechnung (Erträge/Aufwendungen), Finanzrechnung (Ein-/Auszahlungen) und Bilanz (Bestände am 31.12.) sind verschiedene Größen und werden nicht miteinander verrechnet.\n- Aus Ertrags- und Aufwandslisten folgt keine Zweckbindung: Einnahmen werden keiner bestimmten Aufgabe zugeordnet.\n- Beträge in wert sind Euro (bei einheit EUR); wert_text ist dieselbe Zahl lesbar gerundet.\n- Fehlt ein Jahr oder Status in einer Reihe, liegt er in dieser Tabelle nicht vor. Dann eine passende andere Tabelle prüfen, aber keine Werte schätzen oder auffüllen."},"servers":[{"url":"https://www.was-kostet-bonn.de/api/v1"}],"security":[{"basicAuth":[]}],"paths":{"/index.json":{"get":{"operationId":"getGuide","summary":"Einstieg: Regeln, Statusbegriffe, Beispielfragen, Endpunkte","responses":{"200":{"description":"Einstieg","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/aufgaben.json":{"get":{"operationId":"listTasks","summary":"Alle Produktbereiche und Produktgruppen mit Suchbegriffen","responses":{"200":{"description":"Verzeichnis","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/aufgaben/{code}.json":{"get":{"operationId":"getTask","summary":"Ein Produktbereich mit Produktgruppen: Aufwand, Ertrag und Aufwand nach Art je Jahr und Status","parameters":[{"name":"code","in":"path","required":true,"description":"Produktbereich, z. B. 1-05 für 1.05 Soziale Leistungen","schema":{"enum":["1-01","1-02","1-03","1-04","1-05","1-06","1-07","1-08","1-09","1-10","1-11","1-12","1-13","1-14","1-15","1-16","1-17"]}}],"responses":{"200":{"description":"Produktbereich","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Aufgabe"}}}}}}},"/kennzahlen.json":{"get":{"operationId":"listMetrics","summary":"Alle stadtweiten Zeitreihen nach Tabelle","responses":{"200":{"description":"Verzeichnis","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/kennzahlen/{id}.json":{"get":{"operationId":"getMetric","summary":"Eine stadtweite Zeitreihe mit Hinweisen und Quellen","parameters":[{"name":"id","in":"path","required":true,"schema":{"enum":["ergebnis-revenue-total","ergebnis-expense-gross","ergebnis-global-saving","ergebnis-year-result-after-global-saving","ergebnis-operating-result-before-global-saving","ergebnisarten-ertrag-tax","ergebnisarten-ertrag-grants","ergebnisarten-ertrag-transfers","ergebnisarten-ertrag-public-fees","ergebnisarten-ertrag-private-fees","ergebnisarten-ertrag-reimbursements","ergebnisarten-ertrag-other-revenue","ergebnisarten-ertrag-own-work","ergebnisarten-ertrag-finance-revenue","ergebnisarten-ertrag-extraordinary-revenue","ergebnisarten-aufwand-personnel","ergebnisarten-aufwand-pensions","ergebnisarten-aufwand-goods-services","ergebnisarten-aufwand-depreciation","ergebnisarten-aufwand-transfers","ergebnisarten-aufwand-other-expense","ergebnisarten-aufwand-finance-expense","ergebnisarten-aufwand-extraordinary-expense","finanzrechnung-operating-inflows","finanzrechnung-operating-outflows","finanzrechnung-operating-cashflow","finanzrechnung-investment-inflows","finanzrechnung-investment-outflows","finanzrechnung-investment-cashflow","finanzrechnung-pre-financing-cashflow","finanzrechnung-financing-cashflow","finanzrechnung-liquid-funds-change","finanzrechnung-liquid-funds-opening","finanzrechnung-third-party-funds-change","finanzrechnung-liquid-funds-end","finanzrechnung-investition-land-buildings","finanzrechnung-investition-construction","finanzrechnung-investition-movable-assets","finanzrechnung-investition-financial-assets","bilanz-aktiva-preservation","bilanz-aktiva-fixed-assets","bilanz-aktiva-current-assets","bilanz-aktiva-accruals","bilanz-aktiva-total","bilanz-passiva-equity","bilanz-passiva-special-items","bilanz-passiva-provisions","bilanz-passiva-liabilities","bilanz-passiva-accruals","bilanz-passiva-total","bilanz-aktiva-cash","bilanz-aktiva-infrastructure","bilanz-aktiva-financial-assets","anlagenspiegel-infrastructure-additions","anlagenspiegel-infrastructure-transfers","anlagenspiegel-infrastructure-disposals","anlagenspiegel-infrastructure-depreciation","anlagenspiegel-infrastructure-other","kredite-investment-loans","kredite-liquidity-loans","kredite-core-debt","kredite-core-debt-per-capita","kreditplanung-investment-loans","kreditplanung-liquidity-loans","verbindlichkeiten-investment-loans","verbindlichkeiten-liquidity-loans","verbindlichkeiten-credit-equivalent","verbindlichkeiten-supplier","verbindlichkeiten-transfer","verbindlichkeiten-other","verbindlichkeiten-advances","verbindlichkeiten-total","eigenkapital-equity","eigenkapital-year-result","einwohner-population","stellen-beamte","stellen-tarif","stellen-beamte-besetzt","stellen-tarif-besetzt"]}}],"responses":{"200":{"description":"Zeitreihe","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Kennzahl"}}}}}}}},"components":{"securitySchemes":{"basicAuth":{"type":"http","scheme":"basic"}},"schemas":{"Wert":{"type":"object","required":["jahr","status","status_text","wert","wert_text","quelle"],"properties":{"jahr":{"type":"integer"},"status":{"enum":["actual","preliminary","plan","forecast"]},"status_text":{"type":"string","description":"Ist, Entwurf, Plan, Prognose, Mittelfristige Planung oder Plan (Open-Data-Archiv)"},"wert":{"type":"number","description":"Euro bei einheit EUR, sonst Anzahl"},"wert_text":{"type":"string"},"quelle":{"type":"string","description":"Schlüssel in quellen"},"planstand":{"enum":["urspruenglich","vorjahresansatz","fortgeschrieben","archiv"],"description":"Nur bei status plan: welcher Planstand"},"mittelfristig":{"const":true,"description":"Planjahr der mittelfristigen Finanzplanung; status bleibt plan"},"vergleichbar_mit_ist":{"const":false,"description":"Nicht mit Ist oder Entwurf vergleichen (Open-Data-Planarchiv 2008–2024)"}}},"Quellen":{"type":"object","additionalProperties":{"type":"object","properties":{"titel":{"type":"string"},"url":{"type":"string"}}}},"Kennzahl":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"rechnung":{"type":"string"},"einheit":{"enum":["EUR","Personen","Stellen"]},"hinweise":{"type":"array","items":{"type":"string"}},"werte":{"type":"array","items":{"$ref":"#/components/schemas/Wert"}},"quellen":{"$ref":"#/components/schemas/Quellen"}}},"Aufgabe":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"aufwand":{"type":"array","items":{"$ref":"#/components/schemas/Wert"}},"ertrag":{"type":"array","items":{"$ref":"#/components/schemas/Wert"}},"hinweise":{"type":"array","items":{"type":"string"}},"hinweise_bereich":{"type":"array","items":{"type":"string"}},"produktgruppen":{"type":"array","items":{"type":"object"}},"quellen":{"$ref":"#/components/schemas/Quellen"}}}}}}