{"openapi":"3.1.0","info":{"title":"Antragio Förderdaten-API","version":"1","summary":"Öffentliche, schreibgeschützte Suche in den Förderprogrammen von Bund, Land, EU und Kommunen.","description":"Ohne Schlüssel, ohne Anmeldung, ohne Personendaten. Jede Antwort trägt einen Hinweis auf\ndie Originalquelle des Fördergebers.\n\nAntragio reicht nichts im Namen eines Nutzers ein, gibt keine Erklärung für ihn ab und sagt\nkeine Bewilligung zu. Es gibt hier bewusst keinen schreibenden Endpunkt.\n\nBeschreibung für Agentenbetreiber: https://antragio.com/agents","termsOfService":"https://antragio.com/agb","contact":{"name":"Antragio","url":"https://antragio.com/impressum"},"license":{"name":"Freie Nutzung mit Quellenangabe","url":"https://antragio.com/agenten"}},"servers":[{"url":"https://antragio.com","description":"Produktion"}],"externalDocs":{"description":"Anleitung für KI-Agenten","url":"https://antragio.com/agents"},"tags":[{"name":"Programme","description":"Lesen und Filtern der Förderprogramme."},{"name":"Taxonomie","description":"Erlaubte Werte für alle Filter."},{"name":"Matching","description":"Bewertung einer konkreten Situation."}],"paths":{"/api/v1/programs":{"get":{"tags":["Programme"],"operationId":"listPrograms","summary":"Förderprogramme auflisten und filtern.","description":"Alle Filter sind kombinierbar und werden als UND verknüpft. Ein unbekannter Wert führt zu 400 statt zu einer stillen leeren Liste.","parameters":[{"name":"q","in":"query","required":false,"description":"Volltextsuche über Name, Fördergeber und Kurzbeschreibung.","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Kategorie-Slug.","schema":{"type":"string","enum":["energie","sanierung","heizung","photovoltaik","daemmung","fenster-tueren","neubau","wohneigentum","mobilitaet","thg","gruendung","digitalisierung","forschung","personal","bildung","familie","natur","landwirtschaft","kultur","sport","soziales","ehrenamt","export","sozialleistung","wohnen","gesundheit","migration","sonstiges"]}},{"name":"level","in":"query","required":false,"description":"Förderebene.","schema":{"type":"string","enum":["bund","land","eu","kommune","sonstige"]}},{"name":"fundingType","in":"query","required":false,"description":"Art der Förderung.","schema":{"type":"string","enum":["zuschuss","kredit","buergschaft","beteiligung","steuervorteil","beratung","praemie","sonstiges"]}},{"name":"targetGroup","in":"query","required":false,"description":"Zielgruppe.","schema":{"type":"string","enum":["privat","unternehmen","selbstaendig","gruender","verein","kommune","landwirt","student","arbeitnehmer","vermieter"]}},{"name":"region","in":"query","required":false,"description":"Bundesland-Kürzel. Bundesweite und EU-Programme sind immer enthalten, kommunale Programme des Bundeslandes ebenfalls.","schema":{"type":"string","enum":["BW","BY","BE","BB","HB","HH","HE","MV","NI","NW","RP","SL","SN","ST","SH","TH","DE","BUND","EU"]}},{"name":"status","in":"query","required":false,"description":"Antragslage des Programms.","schema":{"type":"string","enum":["aktiv","ausgelaufen","geplant"]}},{"name":"limit","in":"query","required":false,"description":"Treffer je Seite.","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"offset","in":"query","required":false,"description":"Versatz für die Blätterung.","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Seite der Trefferliste.","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer","description":"Treffer insgesamt, nicht nur auf dieser Seite."},"limit":{"type":"integer"},"offset":{"type":"integer"},"count":{"type":"integer"},"filters":{"type":"object","description":"Die Filter, wie der Server sie verstanden hat."},"programs":{"type":"array","items":{"type":"object","description":"Ein Förderprogramm. Beträge, Sätze und Fristen sind Angaben aus der jeweiligen Richtlinie und keine Zusage. Verbindlich ist allein sourceUrl.","properties":{"slug":{"type":"string","description":"Stabiler Schlüssel des Programms."},"name":{"type":"string"},"provider":{"type":"string","description":"Fördergeber, zum Beispiel KfW oder BAFA."},"level":{"type":"string","enum":["bund","land","eu","kommune","sonstige"]},"regions":{"type":"array","items":{"type":"string"},"description":"Bundesland-Kürzel. DE oder BUND bedeutet bundesweit, EU europaweit."},"targetGroups":{"type":"array","items":{"type":"string","enum":["privat","unternehmen","selbstaendig","gruender","verein","kommune","landwirt","student","arbeitnehmer","vermieter"]}},"categories":{"type":"array","items":{"type":"string","enum":["energie","sanierung","heizung","photovoltaik","daemmung","fenster_tueren","neubau","wohneigentum","mobilitaet","thg","gruendung","digitalisierung","forschung","personal","bildung","familie","natur","landwirtschaft","kultur","sport","soziales","ehrenamt","export","sozialleistung","wohnen","gesundheit","migration","sonstiges"]}},"fundingType":{"type":"string","enum":["zuschuss","kredit","buergschaft","beteiligung","steuervorteil","beratung","praemie","sonstiges"]},"amountMin":{"type":["number","null"],"description":"Untere Grenze der Förderung in Euro, falls bekannt."},"amountMax":{"type":["number","null"],"description":"Obere Grenze der Förderung in Euro, falls bekannt."},"ratePercent":{"type":["number","null"],"description":"Fördersatz in Prozent. Nicht mit der Investitionssumme multiplizieren: Boni, Deckel je Einheit und Kumulierungsgrenzen stehen nicht in diesem Feld."},"shortDescription":{"type":"string"},"requirements":{"type":"array","items":{"type":"string"}},"deadline":{"type":["string","null"],"description":"Frist als Text, falls das Programm eine hat."},"combinableWith":{"type":"array","items":{"type":"string"}},"applicationUrl":{"type":["string","null"],"format":"uri"},"sourceUrl":{"type":["string","null"],"format":"uri","description":"Originalquelle des Fördergebers."},"status":{"type":"string","enum":["aktiv","ausgelaufen","geplant"]},"confidence":{"type":"string","description":"Wie gut die Angabe belegt ist."},"lastVerified":{"type":["string","null"],"format":"date-time"},"url":{"type":"string","format":"uri","description":"Menschenlesbare Seite auf antragio.com."}},"required":["slug","name","provider","level","categories","fundingType","status","url"]}},"disclaimer":{"type":"string","description":"Angaben ohne Gewähr. Verbindlich ist allein die jeweils gültige Richtlinie des Fördergebers. Diese Daten sind keine Förder-, Rechts- oder Steuerberatung."},"license":{"type":"string","description":"Freie Nutzung mit Quellenangabe: Antragio (https://antragio.com). Bitte den Abrufzeitpunkt mit angeben, Förderprogramme ändern sich laufend."}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/api/v1/programs/{slug}":{"get":{"tags":["Programme"],"operationId":"getProgram","summary":"Ein Programm mit allen Feldern.","parameters":[{"name":"slug","in":"path","required":true,"description":"Slug aus einer Trefferliste.","schema":{"type":"string"}}],"responses":{"200":{"description":"Das Programm.","content":{"application/json":{"schema":{"type":"object","properties":{"program":{"type":"object","description":"Ein Förderprogramm. Beträge, Sätze und Fristen sind Angaben aus der jeweiligen Richtlinie und keine Zusage. Verbindlich ist allein sourceUrl.","properties":{"slug":{"type":"string","description":"Stabiler Schlüssel des Programms."},"name":{"type":"string"},"provider":{"type":"string","description":"Fördergeber, zum Beispiel KfW oder BAFA."},"level":{"type":"string","enum":["bund","land","eu","kommune","sonstige"]},"regions":{"type":"array","items":{"type":"string"},"description":"Bundesland-Kürzel. DE oder BUND bedeutet bundesweit, EU europaweit."},"targetGroups":{"type":"array","items":{"type":"string","enum":["privat","unternehmen","selbstaendig","gruender","verein","kommune","landwirt","student","arbeitnehmer","vermieter"]}},"categories":{"type":"array","items":{"type":"string","enum":["energie","sanierung","heizung","photovoltaik","daemmung","fenster_tueren","neubau","wohneigentum","mobilitaet","thg","gruendung","digitalisierung","forschung","personal","bildung","familie","natur","landwirtschaft","kultur","sport","soziales","ehrenamt","export","sozialleistung","wohnen","gesundheit","migration","sonstiges"]}},"fundingType":{"type":"string","enum":["zuschuss","kredit","buergschaft","beteiligung","steuervorteil","beratung","praemie","sonstiges"]},"amountMin":{"type":["number","null"],"description":"Untere Grenze der Förderung in Euro, falls bekannt."},"amountMax":{"type":["number","null"],"description":"Obere Grenze der Förderung in Euro, falls bekannt."},"ratePercent":{"type":["number","null"],"description":"Fördersatz in Prozent. Nicht mit der Investitionssumme multiplizieren: Boni, Deckel je Einheit und Kumulierungsgrenzen stehen nicht in diesem Feld."},"shortDescription":{"type":"string"},"requirements":{"type":"array","items":{"type":"string"}},"deadline":{"type":["string","null"],"description":"Frist als Text, falls das Programm eine hat."},"combinableWith":{"type":"array","items":{"type":"string"}},"applicationUrl":{"type":["string","null"],"format":"uri"},"sourceUrl":{"type":["string","null"],"format":"uri","description":"Originalquelle des Fördergebers."},"status":{"type":"string","enum":["aktiv","ausgelaufen","geplant"]},"confidence":{"type":"string","description":"Wie gut die Angabe belegt ist."},"lastVerified":{"type":["string","null"],"format":"date-time"},"url":{"type":"string","format":"uri","description":"Menschenlesbare Seite auf antragio.com."}},"required":["slug","name","provider","level","categories","fundingType","status","url"]},"disclaimer":{"type":"string","description":"Angaben ohne Gewähr. Verbindlich ist allein die jeweils gültige Richtlinie des Fördergebers. Diese Daten sind keine Förder-, Rechts- oder Steuerberatung."},"license":{"type":"string","description":"Freie Nutzung mit Quellenangabe: Antragio (https://antragio.com). Bitte den Abrufzeitpunkt mit angeben, Förderprogramme ändern sich laufend."}}}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/api/v1/categories":{"get":{"tags":["Taxonomie"],"operationId":"listCategories","summary":"Alle erlaubten Filterwerte, mit Anzahl je Kategorie.","description":"Der richtige erste Aufruf. Danach steht fest, welche Werte die anderen Endpunkte annehmen. Ist die Datenbank gerade nicht erreichbar, kommt die Liste ohne Anzahlen und countsAvailable ist false.","responses":{"200":{"description":"Taxonomie.","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer"},"countsAvailable":{"type":"boolean"},"categories":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","enum":["energie","sanierung","heizung","photovoltaik","daemmung","fenster_tueren","neubau","wohneigentum","mobilitaet","thg","gruendung","digitalisierung","forschung","personal","bildung","familie","natur","landwirtschaft","kultur","sport","soziales","ehrenamt","export","sozialleistung","wohnen","gesundheit","migration","sonstiges"]},"label":{"type":"string"},"slug":{"type":"string","enum":["energie","sanierung","heizung","photovoltaik","daemmung","fenster-tueren","neubau","wohneigentum","mobilitaet","thg","gruendung","digitalisierung","forschung","personal","bildung","familie","natur","landwirtschaft","kultur","sport","soziales","ehrenamt","export","sozialleistung","wohnen","gesundheit","migration","sonstiges"]},"programCount":{"type":["integer","null"]},"url":{"type":"string","format":"uri"}}}},"levels":{"type":"array","items":{"type":"object"}},"fundingTypes":{"type":"array","items":{"type":"object"}},"targetGroups":{"type":"array","items":{"type":"object"}},"disclaimer":{"type":"string","description":"Angaben ohne Gewähr. Verbindlich ist allein die jeweils gültige Richtlinie des Fördergebers. Diese Daten sind keine Förder-, Rechts- oder Steuerberatung."},"license":{"type":"string","description":"Freie Nutzung mit Quellenangabe: Antragio (https://antragio.com). Bitte den Abrufzeitpunkt mit angeben, Förderprogramme ändern sich laufend."}}}}}},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/api/v1/match":{"post":{"tags":["Matching"],"operationId":"matchPrograms","summary":"Passende Programme zu einer beschriebenen Situation.","description":"Zustandslos: nichts wird gespeichert, es entsteht kein Konto und kein Cookie. Unbekannte Schlüssel in answers werden verworfen, statt einen Fehler auszulösen. estimatedAmount und estimatedPotential sind Schätzungen aus den Spannen der Programme und ausdrücklich keine Zusage über eine Auszahlung.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"answers":{"type":"object","description":"Die Situation. Alle Felder sind freiwillig, je mehr gesetzt sind, desto genauer die Bewertung. Unbekannte Felder werden ignoriert.","properties":{"persona":{"type":"string","enum":["privat","unternehmen","selbstaendig","gruender","verein","kommune","landwirt","student","arbeitnehmer","vermieter"]},"bundesland":{"type":"string","enum":["BW","BY","BE","BB","HB","HH","HE","MV","NI","NW","RP","SL","SN","ST","SH","TH"]},"plz":{"type":"string","pattern":"^\\d{4,5}$"},"vorhaben":{"type":"array","items":{"type":"string","enum":["energie","sanierung","heizung","photovoltaik","daemmung","fenster_tueren","neubau","wohneigentum","mobilitaet","thg","gruendung","digitalisierung","forschung","personal","bildung","familie","natur","landwirtschaft","kultur","sport","soziales","ehrenamt","export","sozialleistung","wohnen","gesundheit","migration","sonstiges"]}},"eigentum":{"type":"string","enum":["eigentuemer","kaufabsicht","mieter"]},"budget":{"type":"string","enum":["unter5k","5_20k","20_100k","100k_500k","ueber500k","unklar"]},"zeithorizont":{"type":"string","enum":["sofort","3_monate","12_monate","spaeter"]}},"additionalProperties":true},"limit":{"type":"integer","minimum":1,"maximum":100,"default":25},"offset":{"type":"integer","minimum":0,"default":0}},"required":["answers"]}}}},"responses":{"200":{"description":"Bewertete Treffer, absteigend nach Punktzahl.","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"count":{"type":"integer"},"totalConsidered":{"type":"integer"},"estimatedPotential":{"type":"integer","description":"Grobe Summe der Schätzungen, keine Zusage."},"answersUsed":{"type":"object","description":"Die Antworten nach der Bereinigung."},"matches":{"type":"array","items":{"type":"object","properties":{"score":{"type":"number"},"estimatedAmount":{"type":["number","null"]},"reasons":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}},"checklist":{"type":"array","items":{"type":"string"}},"program":{"type":"object","description":"Ein Förderprogramm. Beträge, Sätze und Fristen sind Angaben aus der jeweiligen Richtlinie und keine Zusage. Verbindlich ist allein sourceUrl.","properties":{"slug":{"type":"string","description":"Stabiler Schlüssel des Programms."},"name":{"type":"string"},"provider":{"type":"string","description":"Fördergeber, zum Beispiel KfW oder BAFA."},"level":{"type":"string","enum":["bund","land","eu","kommune","sonstige"]},"regions":{"type":"array","items":{"type":"string"},"description":"Bundesland-Kürzel. DE oder BUND bedeutet bundesweit, EU europaweit."},"targetGroups":{"type":"array","items":{"type":"string","enum":["privat","unternehmen","selbstaendig","gruender","verein","kommune","landwirt","student","arbeitnehmer","vermieter"]}},"categories":{"type":"array","items":{"type":"string","enum":["energie","sanierung","heizung","photovoltaik","daemmung","fenster_tueren","neubau","wohneigentum","mobilitaet","thg","gruendung","digitalisierung","forschung","personal","bildung","familie","natur","landwirtschaft","kultur","sport","soziales","ehrenamt","export","sozialleistung","wohnen","gesundheit","migration","sonstiges"]}},"fundingType":{"type":"string","enum":["zuschuss","kredit","buergschaft","beteiligung","steuervorteil","beratung","praemie","sonstiges"]},"amountMin":{"type":["number","null"],"description":"Untere Grenze der Förderung in Euro, falls bekannt."},"amountMax":{"type":["number","null"],"description":"Obere Grenze der Förderung in Euro, falls bekannt."},"ratePercent":{"type":["number","null"],"description":"Fördersatz in Prozent. Nicht mit der Investitionssumme multiplizieren: Boni, Deckel je Einheit und Kumulierungsgrenzen stehen nicht in diesem Feld."},"shortDescription":{"type":"string"},"requirements":{"type":"array","items":{"type":"string"}},"deadline":{"type":["string","null"],"description":"Frist als Text, falls das Programm eine hat."},"combinableWith":{"type":"array","items":{"type":"string"}},"applicationUrl":{"type":["string","null"],"format":"uri"},"sourceUrl":{"type":["string","null"],"format":"uri","description":"Originalquelle des Fördergebers."},"status":{"type":"string","enum":["aktiv","ausgelaufen","geplant"]},"confidence":{"type":"string","description":"Wie gut die Angabe belegt ist."},"lastVerified":{"type":["string","null"],"format":"date-time"},"url":{"type":"string","format":"uri","description":"Menschenlesbare Seite auf antragio.com."}},"required":["slug","name","provider","level","categories","fundingType","status","url"]}}}},"disclaimer":{"type":"string","description":"Angaben ohne Gewähr. Verbindlich ist allein die jeweils gültige Richtlinie des Fördergebers. Diese Daten sind keine Förder-, Rechts- oder Steuerberatung."},"license":{"type":"string","description":"Freie Nutzung mit Quellenangabe: Antragio (https://antragio.com). Bitte den Abrufzeitpunkt mit angeben, Förderprogramme ändern sich laufend."}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}}},"components":{"responses":{"BadRequest":{"description":"Ein Parameter hat einen unbekannten Wert.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Zu diesem Slug gibt es kein Programm.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Ratengrenze erreicht. Der Header retry-after nennt die Wartezeit in Sekunden.","headers":{"retry-after":{"schema":{"type":"integer"},"description":"Sekunden bis zum nächsten Versuch."},"x-ratelimit-limit":{"schema":{"type":"integer"}},"x-ratelimit-remaining":{"schema":{"type":"integer"}},"x-ratelimit-reset":{"schema":{"type":"integer"},"description":"Unix-Zeit, wann das Budget zurückgesetzt wird."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unavailable":{"description":"Die Programmdaten sind gerade nicht erreichbar.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"},"disclaimer":{"type":"string"},"license":{"type":"string"}},"required":["error"]}}}}