{"uid":"cap_EjPjNeiZl9RG1oOb_j_le","slug":"vergabe-api-german-public-procurement-notices-130420e1","name":"Vergabe API – German Public Procurement Notices","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.","url":"https://vergabe-api.applehorsefrog.workers.dev/v1/notices","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"q":{"type":"string","description":"substring search in title, description, buyer (min 3 chars)"},"cpv":{"type":"string","description":"CPV codes or prefixes, comma separated, e.g. 45 or 45,7131"},"kind":{"enum":["competition","result","planning","change","all"],"type":"string","description":"notice kind, default competition (calls for tenders)"},"nuts":{"type":"string","description":"NUTS region prefixes, comma separated, e.g. DE2 (Bavaria)"},"sort":{"enum":["published","deadline"],"type":"string"},"limit":{"type":"integer","description":"1..100, default 50"},"since":{"type":"string","description":"publication day >= YYYY-MM-DD"},"until":{"type":"string","description":"publication day <= YYYY-MM-DD"},"fields":{"enum":["compact","full"],"type":"string"},"nature":{"enum":["works","services","supplies"],"type":"string"},"offset":{"type":"integer","description":"0..5000"},"min_value":{"type":"number","description":"estimated value >= (EUR)"},"buyer_type":{"type":"string","description":"eForms buyer-legal-type code, e.g. kommun-beh"},"deadline_after":{"type":"string","description":"submission deadline >= YYYY-MM-DD"},"deadline_before":{"type":"string","description":"submission deadline <= YYYY-MM-DD"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"count":1,"limit":20,"total":142,"offset":0,"notices":[{"id":"0066c4ef-f672-4717-aa5b-8b0d589a64a6-01","kind":"competition","title":"Beschaffung von mobilen Zufahrtsschutzelementen","nature":"supplies","cpv_main":"34928300","lot_count":2,"procedure":"open","published":"2026-09-10","buyer_city":"Mannheim","buyer_name":"Stadt Mannheim","buyer_type":"kommun-beh","place_nuts":"DE126","source_url":"https://oeffentlichevergabe.de/api/notices/0066c4ef-...?format=eforms-de&noticeVersion=01","legal_basis":"vgv","notice_type":"cn-standard","deadline_date":"2026-09-24","deadline_kind":"tender","deadline_time":"10:15","documents_url":"https://vergabe.vmstart.de/...","cpv_additional":["35000000"]}],"attribution":"Datenservice Öffentlicher Einkauf (oeffentlichevergabe.de), CC0-1.0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7yRivOZAptUhxGY0OougS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search and filter normalised German public procurement notices (calls for tender, results, planning) sourced from the official eForms-DE feed of oeffentlichevergabe.de","exampleAgentPrompt":"Find me up to 20 open German public tenders for IT services (CPV prefix 72) in Bavaria (NUTS DE2) with a submission deadline after 2025-01-01, sorted by deadline.","exampleUseCases":[{"title":"Monitor new construction tenders in a region","prompt":"Show me all new competition notices for construction works (CPV prefix 45) published since 2025-06-01 in Saxony (NUTS DED), sorted by publication date, up to 50 results."},{"title":"Find high-value supply contracts near deadline","prompt":"Find German procurement notices for supplies worth at least €500,000 with submission deadlines before 2025-09-30 — I want full details on each one."},{"title":"Research awarded contracts for a specific buyer type","prompt":"Get me the latest procurement results issued by municipal authorities (buyer type kommun-beh) for security equipment, using CPV code 35, limited to the last 30 results."}],"resultDescription":"A JSON object containing a paginated list of procurement notices, each with fields including notice ID, kind (competition/result/planning/change), title, nature (works/services/supplies), main CPV code, additional CPV codes, lot count, procedure type, publication date, buyer name, buyer city, buyer type, NUTS region, submission deadline (date, time, kind), link to the official source on oeffentlichevergabe.de, and link to tender documents. Also includes total count, offset, limit, and a CC0 attribution string.","failureModes":["Query string too short (min 3 chars for q parameter) – returns 400 or empty results","Invalid CPV or NUTS code format – may return empty result set rather than an error","offset > 5000 – rejected by schema","Payment not processed (HTTP 402) – request blocked until USDC payment via x402 protocol is completed","Date format not matching YYYY-MM-DD – schema validation error","limit outside 1–100 range – validation error","No matching notices for very specific filters – returns count:0 with empty notices array"],"whenToPreferThis":"Use this endpoint when you need structured, normalised access to German public procurement notices from the official national feed, including both EU-threshold and below-threshold notices, with flexible filtering by keyword, CPV code, NUTS region, deadline, value, and buyer type. Prefer it over scraping oeffentlichevergabe.de directly because it provides normalised JSON output with consistent field names and supports powerful multi-parameter queries. It is especially suited for agents that need to monitor tender pipelines, qualify business development leads, or do procurement market research in Germany.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-19T12:33:43.099Z","isFirstParty":false}