{"openapi":"3.1.0","info":{"title":"Schlenderli Agent API","version":"1.0.0","description":"Public event facts. Attribution: Schlenderli; each event links its source. No third-party content licence is granted."},"servers":[{"url":"https://schlenderli.de/api/agent/v1"}],"paths":{"/cities":{"get":{"operationId":"cities","parameters":[],"responses":{"200":{"description":"Public facts projection","content":{"application/json":{"schema":{"type":"object"}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"Repairable request error","content":{"application/json":{"schema":{"type":"object"}},"text/markdown":{"schema":{"type":"string"}}}},"404":{"description":"Repairable request error","content":{"application/json":{"schema":{"type":"object"}},"text/markdown":{"schema":{"type":"string"}}}},"410":{"description":"Cursor expired","content":{"application/json":{"schema":{"type":"object"}},"text/markdown":{"schema":{"type":"string"}}}},"429":{"description":"Repairable request error","content":{"application/json":{"schema":{"type":"object"}},"text/markdown":{"schema":{"type":"string"}}}},"503":{"description":"Repairable request error","content":{"application/json":{"schema":{"type":"object"}},"text/markdown":{"schema":{"type":"string"}}}}}}},"/interests":{"get":{"operationId":"interests","parameters":[],"responses":{"200":{"description":"Public facts projection","content":{"application/json":{"schema":{"type":"object"}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"Repairable request error","content":{"application/json":{"schema":{"type":"object"}},"text/markdown":{"schema":{"type":"string"}}}},"404":{"description":"Repairable request error","content":{"application/json":{"schema":{"type":"object"}},"text/markdown":{"schema":{"type":"string"}}}},"410":{"description":"Cursor expired","content":{"application/json":{"schema":{"type":"object"}},"text/markdown":{"schema":{"type":"string"}}}},"429":{"description":"Repairable request error","content":{"application/json":{"schema":{"type":"object"}},"text/markdown":{"schema":{"type":"string"}}}},"503":{"description":"Repairable request error","content":{"application/json":{"schema":{"type":"object"}},"text/markdown":{"schema":{"type":"string"}}}}}}},"/events":{"get":{"operationId":"events","parameters":[{"name":"city","in":"query","schema":{"type":"string"}},{"name":"lat","in":"query","schema":{"type":"number","minimum":-90,"maximum":90}},{"name":"lng","in":"query","schema":{"type":"number","minimum":-180,"maximum":180}},{"name":"radius_km","in":"query","schema":{"type":"number","exclusiveMinimum":0,"maximum":100,"default":10}},{"name":"date","in":"query","schema":{"type":"string","description":"Europe/Berlin calendar date: today, tomorrow, weekend, YYYY-MM-DD or inclusive YYYY-MM-DD..YYYY-MM-DD. Default next seven days; maximum 31 days."}},{"name":"q","in":"query","schema":{"type":"string","maxLength":200,"description":"Lexical Theme search; at most 20 words."}},{"name":"interest","in":"query","schema":{"type":"string"}},{"name":"price","in":"query","schema":{"type":"string","enum":["any","free","lt10","lt25","lt50"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":25,"default":10}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"time_match","in":"query","schema":{"type":"string","enum":["start","overlap"],"description":"Opt-in half-open catalog overlap, with upcoming/started/ongoing grouping and a separate frozen cursor. Unavailable until migration rollout; omitted retains legacy start mode."}},{"name":"format","in":"query","schema":{"type":"string","enum":["json","md"]}}],"responses":{"200":{"description":"Public facts projection","content":{"application/json":{"schema":{"type":"object"}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"Repairable request error","content":{"application/json":{"schema":{"type":"object"}},"text/markdown":{"schema":{"type":"string"}}}},"404":{"description":"Repairable request error","content":{"application/json":{"schema":{"type":"object"}},"text/markdown":{"schema":{"type":"string"}}}},"410":{"description":"Cursor expired","content":{"application/json":{"schema":{"type":"object"}},"text/markdown":{"schema":{"type":"string"}}}},"429":{"description":"Repairable request error","content":{"application/json":{"schema":{"type":"object"}},"text/markdown":{"schema":{"type":"string"}}}},"503":{"description":"Repairable request error","content":{"application/json":{"schema":{"type":"object"}},"text/markdown":{"schema":{"type":"string"}}}}}}},"/events/{id}":{"get":{"operationId":"events__id_","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Public facts projection","content":{"application/json":{"schema":{"type":"object"}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"Repairable request error","content":{"application/json":{"schema":{"type":"object"}},"text/markdown":{"schema":{"type":"string"}}}},"404":{"description":"Repairable request error","content":{"application/json":{"schema":{"type":"object"}},"text/markdown":{"schema":{"type":"string"}}}},"410":{"description":"Cursor expired","content":{"application/json":{"schema":{"type":"object"}},"text/markdown":{"schema":{"type":"string"}}}},"429":{"description":"Repairable request error","content":{"application/json":{"schema":{"type":"object"}},"text/markdown":{"schema":{"type":"string"}}}},"503":{"description":"Repairable request error","content":{"application/json":{"schema":{"type":"object"}},"text/markdown":{"schema":{"type":"string"}}}}}}}},"components":{"schemas":{"Event":{"type":"object","additionalProperties":false,"required":["id","title","start","end","timezone","venue","price","status","source_url","browse_url"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"start":{"type":"string"},"end":{"type":["string","null"]},"timezone":{"type":"string"},"venue":{"type":"object"},"price":{"type":"object"},"status":{"type":"string"},"source_url":{"type":"string"},"browse_url":{"type":"string"},"kind":{"type":"string"},"event_schedule":{"type":["object","null"]},"time_position":{"type":"string","enum":["upcoming","started","ongoing"]}}}}}}