{"openapi":"3.1.0","info":{"title":"vergabe-api","version":"0.4.2","description":"German public procurement notices (above and below EU thresholds), normalised from the official eForms-DE feed of oeffentlichevergabe.de (CC0). Paid endpoints use x402 (HTTP 402, USDC on Base). Provider: Viono Insights, see /impressum.","contact":{"name":"Viono Insights","email":"kontakt@viono-insights.de","url":"https://viono-insights.de"},"license":{"name":"Data: CC0-1.0; code: MIT","url":"https://github.com/applehorsefrog/vergabe-api"},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC","payTo":"0x64FE7Dab6d5C2265A7dD912f0c1C4dd6614FA5c6"}},"servers":[{"url":"https://vergabe-api.applehorsefrog.workers.dev"}],"paths":{"/v1/sample":{"get":{"operationId":"sample","summary":"Free sample: 5 latest calls for tenders (compact fields)","security":[],"parameters":[{"name":"cpv","in":"query","description":"CPV code or prefix","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/v1/stats":{"get":{"operationId":"stats","summary":"Free: notices per day, last 30 days","security":[],"responses":{"200":{"description":"OK"}}}},"/v1/notices":{"get":{"operationId":"searchNotices","summary":"Filtered notices (x402 paid, $0.01 per call, up to 100 records)","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC","payTo":"0x64FE7Dab6d5C2265A7dD912f0c1C4dd6614FA5c6"},"parameters":[{"name":"kind","in":"query","description":"competition (default) | result | planning | change | all","schema":{"type":"string"}},{"name":"cpv","in":"query","description":"CPV codes or prefixes, comma separated (45 or 45,7131)","schema":{"type":"string"}},{"name":"nuts","in":"query","description":"NUTS region prefixes, comma separated (DE2, DE212)","schema":{"type":"string"}},{"name":"q","in":"query","description":"substring in title, description, buyer (min 3 chars)","schema":{"type":"string"}},{"name":"since","in":"query","description":"publication day >= YYYY-MM-DD","schema":{"type":"string"}},{"name":"until","in":"query","description":"publication day <= YYYY-MM-DD","schema":{"type":"string"}},{"name":"deadline_after","in":"query","description":"submission deadline >= YYYY-MM-DD","schema":{"type":"string"}},{"name":"deadline_before","in":"query","description":"submission deadline <= YYYY-MM-DD","schema":{"type":"string"}},{"name":"nature","in":"query","description":"works | services | supplies","schema":{"type":"string"}},{"name":"procedure","in":"query","description":"eForms procedure code, e.g. open","schema":{"type":"string"}},{"name":"legal_basis","in":"query","description":"vgv | vob | uvgo | ...","schema":{"type":"string"}},{"name":"buyer_type","in":"query","description":"eForms buyer-legal-type code","schema":{"type":"string"}},{"name":"min_value","in":"query","description":"estimated value >= (EUR)","schema":{"type":"number"}},{"name":"limit","in":"query","description":"1..100, default 50","schema":{"type":"integer"}},{"name":"offset","in":"query","description":"0..5000","schema":{"type":"integer"}},{"name":"fields","in":"query","description":"compact (default) | full","schema":{"type":"string"}},{"name":"sort","in":"query","description":"published (default) | deadline","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer"},"count":{"type":"integer"},"notices":{"type":"array","items":{"type":"object"}}}}}}},"402":{"description":"Payment required (x402): see PAYMENT-REQUIRED header"}}}},"/v1/notice/{id}":{"get":{"operationId":"getNotice","summary":"One notice by UUID with lots, deadlines, links (x402 paid, $0.002)","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"network":"eip155:8453","asset":"USDC","payTo":"0x64FE7Dab6d5C2265A7dD912f0c1C4dd6614FA5c6"},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"notice UUID, optionally with -version"}],"responses":{"200":{"description":"OK"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}},"/impressum":{"get":{"summary":"Legal notice (§ 5 DDG)","security":[],"responses":{"200":{"description":"OK"}}}},"/datenschutz":{"get":{"summary":"Privacy notice (Art. 13 GDPR)","security":[],"responses":{"200":{"description":"OK"}}}}}}