{"openapi":"3.1.0","info":{"title":"DACH Tech Events API","version":"2.0.0","summary":"Upcoming tech events, hackathons, conferences and meetups in Germany, Austria and Switzerland.","description":"Structured, regularly updated event data. Pricing: Set by the publisher in the Cloudflare Monetization Gateway. Unpaid requests receive HTTP 402 with payment instructions (x402)."},"servers":[{"url":"https://dropvault.ch"}],"paths":{"/api/v1/data":{"get":{"operationId":"listEvents","summary":"List upcoming events, sorted by start date","parameters":[{"name":"country","in":"query","required":false,"description":"Country code.","schema":{"type":"string","enum":["DE","AT","CH"]}},{"name":"type","in":"query","required":false,"description":"Event type.","schema":{"type":"string","enum":["hackathon","conference","meetup","workshop"]}},{"name":"city","in":"query","required":false,"description":"City, substring match.","schema":{"type":"string"}},{"name":"tag","in":"query","required":false,"description":"Exact topic tag, e.g. ai, security, web3.","schema":{"type":"string"}},{"name":"language","in":"query","required":false,"description":"Event language. Events marked de/en match both de and en.","schema":{"type":"string","enum":["de","en","de/en"]}},{"name":"free","in":"query","required":false,"description":"true = only free events, false = only paid events.","schema":{"type":"boolean"}},{"name":"online","in":"query","required":false,"description":"true = online only, false = in person only.","schema":{"type":"boolean"}},{"name":"from","in":"query","required":false,"description":"Earliest end date (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"Latest start date (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"past","in":"query","required":false,"description":"true includes past events (default: upcoming only).","schema":{"type":"boolean"}},{"name":"limit","in":"query","required":false,"description":"Page size, default 20, max 100.","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"offset","in":"query","required":false,"description":"Offset for paging.","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Event list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventList"}}}},"402":{"description":"Payment required (x402). The response describes how to pay.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/search":{"get":{"operationId":"searchEvents","summary":"Full-text search over title, description, city and tags","parameters":[{"name":"q","in":"query","required":true,"description":"Search terms (all words must match).","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Country code.","schema":{"type":"string","enum":["DE","AT","CH"]}},{"name":"type","in":"query","required":false,"description":"Event type.","schema":{"type":"string","enum":["hackathon","conference","meetup","workshop"]}},{"name":"city","in":"query","required":false,"description":"City, substring match.","schema":{"type":"string"}},{"name":"tag","in":"query","required":false,"description":"Exact topic tag, e.g. ai, security, web3.","schema":{"type":"string"}},{"name":"language","in":"query","required":false,"description":"Event language. Events marked de/en match both de and en.","schema":{"type":"string","enum":["de","en","de/en"]}},{"name":"free","in":"query","required":false,"description":"true = only free events, false = only paid events.","schema":{"type":"boolean"}},{"name":"online","in":"query","required":false,"description":"true = online only, false = in person only.","schema":{"type":"boolean"}},{"name":"from","in":"query","required":false,"description":"Earliest end date (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"Latest start date (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"past","in":"query","required":false,"description":"true includes past events (default: upcoming only).","schema":{"type":"boolean"}},{"name":"limit","in":"query","required":false,"description":"Page size, default 20, max 100.","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"offset","in":"query","required":false,"description":"Offset for paging.","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Matching events","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventList"}}}},"400":{"description":"Missing parameter q","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required (x402). The response describes how to pay.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/events/{id}":{"get":{"operationId":"getEvent","summary":"Get a single event","parameters":[{"name":"id","in":"path","required":true,"description":"Event id, e.g. ev-1a2b3c4d5e6f.","schema":{"type":"string"}}],"responses":{"200":{"description":"Event","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Event"}}}}}},"402":{"description":"Payment required (x402). The response describes how to pay.","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown event id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/events/{id}.ics":{"get":{"operationId":"getEventCalendarFile","summary":"Get a single event as iCalendar file (all-day event)","parameters":[{"name":"id","in":"path","required":true,"description":"Event id, e.g. ev-1a2b3c4d5e6f.","schema":{"type":"string"}}],"responses":{"200":{"description":"iCalendar file","content":{"text/calendar":{"schema":{"type":"string"}}}},"402":{"description":"Payment required (x402). The response describes how to pay.","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown event id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/submit":{"post":{"operationId":"submitEvent","summary":"Submit a new event for moderation (free)","description":"Submissions are stored as pending and appear in the API after approval.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitEvent"}}}},"responses":{"202":{"description":"Accepted, status pending","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"id":{"type":"string"},"status":{"type":"string","enum":["pending"]}}}}}},"422":{"description":"Validation failed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"fields":{"type":"object","additionalProperties":{"type":"string"}}}}}}},"429":{"description":"Too many submissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mcp":{"post":{"operationId":"mcpEndpoint","summary":"Model Context Protocol endpoint (JSON-RPC 2.0 over HTTP POST)","description":"Tools: list_events, search_events. Methods: initialize, ping, tools/list, tools/call.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","integer"]},"method":{"type":"string"},"params":{"type":"object"}}}}}},"responses":{"200":{"description":"JSON-RPC response","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required (x402). The response describes how to pay.","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"schemas":{"Event":{"type":"object","required":["id","title","type","start","end","city","country","online","language","registration_url","url","tags","description","calendar_url","source"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"type":{"type":"string","enum":["hackathon","conference","meetup","workshop"]},"start":{"type":"string","format":"date"},"end":{"type":"string","format":"date","description":"Inclusive end date."},"city":{"type":"string"},"country":{"type":"string","enum":["DE","AT","CH"]},"online":{"type":"boolean"},"language":{"type":"string","enum":["de","en","de/en"]},"price":{"type":["string","null"],"description":"e.g. \"CHF 120\" or \"Free\"."},"is_free":{"type":["boolean","null"],"description":"null = unknown."},"deadline":{"type":["string","null"],"format":"date","description":"Registration deadline."},"registration_url":{"type":"string","format":"uri"},"url":{"type":"string","format":"uri"},"tags":{"type":"array","items":{"type":"string"}},"description":{"type":"string"},"calendar_url":{"type":"string","format":"uri"},"source":{"type":"string","description":"feed:<name> or submission."}}},"EventList":{"type":"object","properties":{"meta":{"type":"object","properties":{"total":{"type":"integer"},"count":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"source":{"type":"string","enum":["live","sample"]},"generatedAt":{"type":"string","format":"date-time"}}},"data":{"type":"array","items":{"$ref":"#/components/schemas/Event"}}}},"SubmitEvent":{"type":"object","required":["title","type","country","start","url","description","contact_email"],"properties":{"title":{"type":"string","minLength":5,"maxLength":120},"type":{"type":"string","enum":["hackathon","conference","meetup","workshop"]},"country":{"type":"string","enum":["DE","AT","CH"]},"city":{"type":"string"},"online":{"type":"boolean"},"start":{"type":"string","format":"date"},"end":{"type":"string","format":"date"},"url":{"type":"string","format":"uri","description":"https only."},"registration_url":{"type":"string","format":"uri"},"price":{"type":"string"},"is_free":{"type":"boolean"},"deadline":{"type":"string","format":"date"},"language":{"type":"string","enum":["de","en","de/en"]},"tags":{"type":"string","description":"Comma separated."},"description":{"type":"string","minLength":20,"maxLength":600},"contact_email":{"type":"string","format":"email","description":"Used for moderation only, never published."}}},"Error":{"type":"object","properties":{"error":{"type":"string"}}}}}}