{"openapi":"3.1.0","info":{"title":"Vergabeweiser API","version":"1.0.0","description":"Öffentliche Ausschreibungen und Zuschläge in Deutschland, aufbereitet aus dem Bekanntmachungsservice (oeffentlichevergabe.de, CC0). Kostenlos. Ohne Schlüssel 60 Anfragen pro Stunde je IP-Adresse, mit kostenlosem Schlüssel 1.000 pro Tag. Jede Antwort enthält Quelle und Stand der Daten. Maßgeblich ist die Bekanntmachung des Auftraggebers.","contact":{"url":"https://vergabeweiser.de/api"},"license":{"name":"Quelldaten CC0 1.0 (Bekanntmachungsservice); Aufbereitung CC BY 4.0, Quelle „Vergabeweiser“","url":"https://vergabeweiser.de/api#regeln"}},"servers":[{"url":"https://vergabeweiser.de/api/v1"}],"security":[[],{"bearer":[]},{"apiKey":[]}],"paths":{"/tenders":{"get":{"operationId":"searchTenders","summary":"Ausschreibungen suchen (wie /suche)","parameters":[{"name":"was","in":"query","required":false,"schema":{"type":"string","description":"Freitext, Gewerk oder Ort, z. B. „Gebäudereinigung Rosenheim“","example":"Dachsanierung"},"description":"Freitext, Gewerk oder Ort, z. B. „Gebäudereinigung Rosenheim“"},{"name":"wo","in":"query","required":false,"schema":{"type":"string","description":"Ort, PLZ, Kreis oder Bundesland; bei gleichnamigen Orten in der Regel der größere („Halle“ = Halle (Saale)) oder der gleichnamige Landkreis („Harburg“), ein anderer mit Kreis oder Zusatz: „Halle (Landkreis Holzminden)“, „Halle (Westf.)“, „Auerbach (Oberpfalz)“","example":"Rosenheim"},"description":"Ort, PLZ, Kreis oder Bundesland; bei gleichnamigen Orten in der Regel der größere („Halle“ = Halle (Saale)) oder der gleichnamige Landkreis („Harburg“), ein anderer mit Kreis oder Zusatz: „Halle (Landkreis Holzminden)“, „Halle (Westf.)“, „Auerbach (Oberpfalz)“"},{"name":"km","in":"query","required":false,"schema":{"type":"integer","enum":[10,25,50,100,200],"description":"Umkreis um „wo“ in km (Standard 50)"},"description":"Umkreis um „wo“ in km (Standard 50)"},{"name":"status","in":"query","required":false,"schema":{"type":"string","description":"offen (Standard), bald (Frist in 7 Tagen), ergebnisse, alle","enum":["offen","bald","ergebnisse","alle"]},"description":"offen (Standard), bald (Frist in 7 Tagen), ergebnisse, alle"},{"name":"branche","in":"query","required":false,"schema":{"type":"string","description":"Gewerk-Slug, z. B. gebaeudereinigung (Liste auf /ausschreibungen)"},"description":"Gewerk-Slug, z. B. gebaeudereinigung (Liste auf /ausschreibungen)"},{"name":"land","in":"query","required":false,"schema":{"type":"string","description":"Bundesland-Slug, z. B. bayern"},"description":"Bundesland-Slug, z. B. bayern"},{"name":"gruppe","in":"query","required":false,"schema":{"type":"string","description":"Auftraggeber-Gruppe wie /thema/{gruppe}: bund (mit Bundeswehr und Autobahn GmbH), bundeswehr, autobahn-gmbh, deutsche-bahn, fraunhofer, aok, deutsche-rentenversicherung, krankenhaeuser, hochschulen, polizei, stadtwerke; nach Titel: schulen, kitas; eu-weit: nur EU-weit bekanntgemacht","enum":["bund","bundeswehr","autobahn-gmbh","deutsche-bahn","fraunhofer","aok","deutsche-rentenversicherung","krankenhaeuser","hochschulen","polizei","stadtwerke","schulen","kitas","eu-weit"]},"description":"Auftraggeber-Gruppe wie /thema/{gruppe}: bund (mit Bundeswehr und Autobahn GmbH), bundeswehr, autobahn-gmbh, deutsche-bahn, fraunhofer, aok, deutsche-rentenversicherung, krankenhaeuser, hochschulen, polizei, stadtwerke; nach Titel: schulen, kitas; eu-weit: nur EU-weit bekanntgemacht"},{"name":"verfahren","in":"query","required":false,"schema":{"type":"string","description":"alle, tw (mit Teilnahmewettbewerb), einladung (nur auf Einladung)","enum":["alle","tw","einladung"]},"description":"alle, tw (mit Teilnahmewettbewerb), einladung (nur auf Einladung)"},{"name":"wert","in":"query","required":false,"schema":{"type":"integer","enum":[0,1],"description":"1: nur mit Wert oder Summe"},"description":"1: nur mit Wert oder Summe"},{"name":"sort","in":"query","required":false,"schema":{"type":"string","description":"frist, neu, wert, treffer","enum":["frist","neu","wert","treffer"]},"description":"frist, neu, wert, treffer"},{"name":"seite","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"description":"Seite, je 20 Treffer"},"description":"Seite, je 20 Treffer"}],"responses":{"200":{"description":"Treffer","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResult"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooMany"}}}},"/tenders/{id}":{"get":{"operationId":"getTender","summary":"Eine Ausschreibung mit Fristen, Losen, Ergebnis und Link zu den Unterlagen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kennung aus der URL, z. B. c9be5d33"}],"responses":{"200":{"description":"Ausschreibung","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenderDetail"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooMany"}}}},"/organisations":{"get":{"operationId":"findOrganisations","summary":"Vergabestellen und Firmen nach Namen finden (nur mit Seite im Index, keine Einzelunternehmen)","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","description":"Name oder sein Anfang, mindestens drei Zeichen","example":"Stadt Köln"},"description":"Name oder sein Anfang, mindestens drei Zeichen"},{"name":"typ","in":"query","required":false,"schema":{"type":"string","description":"Nur Vergabestellen oder nur Firmen; ohne Angabe beides","enum":["vergabestelle","unternehmen"]},"description":"Nur Vergabestellen oder nur Firmen; ohne Angabe beides"}],"responses":{"200":{"description":"Treffer mit slug für /buyers/{slug} und /companies/{slug}","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Object"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooMany"}}}},"/buyers/{slug}":{"get":{"operationId":"getBuyer","summary":"Vergabestelle: Kontakt der Organisation, offene Ausschreibungen, Zuschläge, Wettbewerb, auslaufende Verträge","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Slug aus /vergabestelle/{slug}"}],"responses":{"200":{"description":"Vergabestelle","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Object"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooMany"}}}},"/companies/{slug}":{"get":{"operationId":"getCompanyAwards","summary":"Zuschläge einer Firma (nur Firmen mit eigener Seite, keine Einzelunternehmen); firm_amount ist die Summe der Firma, firm_shared_max ein Betrag, den die Bekanntmachung bei mehreren Gewinnern eines Loses gleich oder fast gleich nennt (meist die gemeinsame Obergrenze einer Rahmenvereinbarung), nicht als Summe der Firma gezählt","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Slug aus /unternehmen/{slug}"},{"name":"seite","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":null}],"responses":{"200":{"description":"Firma mit Zuschlägen","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Object"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooMany"}}}},"/market":{"get":{"operationId":"marketStats","summary":"Marktlage je Gewerk und Region: Ausschreibungen, Angebote je Zuschlag, typische Summen, häufige Gewinner","parameters":[{"name":"branche","in":"query","required":true,"schema":{"type":"string","description":"Gewerk-Slug"},"description":"Gewerk-Slug"},{"name":"land","in":"query","required":false,"schema":{"type":"string","description":"Bundesland-Slug"},"description":"Bundesland-Slug"},{"name":"kreis","in":"query","required":false,"schema":{"type":"string","description":"Kreis-Slug (nur mit land)"},"description":"Kreis-Slug (nur mit land)"}],"responses":{"200":{"description":"Marktlage","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Object"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooMany"}}}},"/expiring":{"get":{"operationId":"expiringContracts","summary":"Dienstleistungs- und Lieferverträge, die laut Bekanntmachung bald auslaufen","parameters":[{"name":"branche","in":"query","required":false,"schema":{"type":"string","description":"Gewerk-Slug"},"description":"Gewerk-Slug"},{"name":"land","in":"query","required":false,"schema":{"type":"string","description":"Bundesland-Slug"},"description":"Bundesland-Slug"},{"name":"vergabestelle","in":"query","required":false,"schema":{"type":"string","description":"Slug der Vergabestelle"},"description":"Slug der Vergabestelle"},{"name":"monate","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":36,"description":"Zeitraum ab heute (Standard 12)"},"description":"Zeitraum ab heute (Standard 12)"}],"responses":{"200":{"description":"Verträge","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Object"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooMany"}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Kostenloser Schlüssel aus „Ihr Konto“"},"apiKey":{"type":"apiKey","in":"header","name":"X-Api-Key"}},"responses":{"NotFound":{"description":"Nicht gefunden oder entfernt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"TooMany":{"description":"Limit erreicht, siehe Header Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"Object":{"type":"object","properties":{"source":{"$ref":"#/components/schemas/Source"}}},"Source":{"type":"object","properties":{"name":{"type":"string"},"license":{"type":"string"},"stand":{"type":["string","null"],"format":"date-time"},"note":{"type":"string"}}},"Money":{"type":["object","null"],"properties":{"amount":{"type":"number"},"currency":{"type":"string"}}},"Tender":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string","format":"uri"},"title":{"type":"string"},"title_ki_generated":{"type":"boolean","description":"Titel in Klartext ist KI-generiert"},"original_title":{"type":"string"},"status":{"type":"string"},"status_text":{"type":["string","null"]},"procedure":{"type":"string"},"eu":{"type":"boolean"},"cpv":{"type":["string","null"]},"gewerk":{"type":["string","null"]},"buyer":{"type":["object","null"],"properties":{"name":{"type":"string"},"url":{"type":["string","null"]}}},"place":{"type":"object","properties":{"city":{"type":"string"},"postcode":{"type":"string"},"kreis":{"type":"string"},"land":{"type":"string"},"text":{"type":"string","description":"Ort wie veröffentlicht, wenn er kein Ortsname ist (Adresse, „bundesweit“)"}}},"published_on":{"type":["string","null"],"format":"date","description":"Erste Bekanntmachung in unseren Daten; bei reinen Ergebnisbekanntmachungen deren Datum"},"deadline":{"type":["object","null"],"properties":{"label":{"type":"string"},"at":{"type":"string","format":"date-time"}}},"estimated_value":{"$ref":"#/components/schemas/Money"},"result":{"type":["object","null"],"properties":{"awarded_on":{"type":["string","null"],"format":"date"},"ended_on":{"type":["string","null"],"format":"date","description":"Aufhebung oder Abschluss ohne Zuschlag"},"winners":{"type":["string","null"]},"sum":{"$ref":"#/components/schemas/Money","description":"Summe in Euro: je Los der größte Zuschlag, Beträge für mehrere Lose einmal"},"framework_max":{"type":["object","null"],"description":"Höchstwert der Rahmenvereinbarung (eForms BT-709), wenn jedes vergebene Los einen nennt: Obergrenze für alle Abrufe, keine Auftragssumme, nicht in sum enthalten. per_lot: bei mehreren Losen der größte Höchstwert eines Loses, nie addiert","properties":{"amount":{"type":"number"},"currency":{"type":"string"},"per_lot":{"type":"boolean"}}},"offers_per_lot":{"type":["object","null"],"description":"Angebote je Los; nicht addieren, Bieter wiederholen sich","properties":{"min":{"type":"integer"},"max":{"type":"integer"},"lots":{"type":"integer"}}}}}}},"TenderDetail":{"allOf":[{"$ref":"#/components/schemas/Tender"},{"type":"object","properties":{"description":{"type":["string","null"]},"deadlines":{"type":"array"},"documents_url":{"type":["string","null"]},"notice_url":{"type":["string","null"]},"lots":{"type":"array"},"awards":{"type":"array"},"notices":{"type":"array"},"source":{"$ref":"#/components/schemas/Source"}}}]},"SearchResult":{"type":"object","properties":{"understood":{"type":"object"},"total":{"type":"integer"},"page":{"type":"integer"},"pages":{"type":"integer"},"results":{"type":"array","items":{"$ref":"#/components/schemas/Tender"}},"search_url":{"type":"string"},"source":{"$ref":"#/components/schemas/Source"}}}}}}