{"openapi":"3.1.0","info":{"title":"hackathonmaxxing","description":"In-person hackathons by city, aggregated from Luma, Devpost, MLH, Devfolio, Unstop, ETHGlobal, HackerEarth and Eventbrite. Start with GET /api/cities, then GET /{city}.json.","version":"1.0"},"paths":{"/og/{slug}.png":{"get":{"summary":"Open Graph Image","operationId":"open_graph_image_og__slug__png_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/cities":{"get":{"tags":["public"],"summary":"All cities and whether they are live","operationId":"api_cities_api_cities_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/events":{"get":{"tags":["public"],"summary":"In-person hackathons, optionally for one city","operationId":"api_events_api_events_get","parameters":[{"name":"city","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"City slug, e.g. dublin","title":"City"},"description":"City slug, e.g. dublin"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Free-text search over title, organizer, venue, themes","title":"Q"},"description":"Free-text search over title, organizer, venue, themes"},{"name":"when","in":"query","required":false,"schema":{"type":"string","pattern":"^(all|ongoing|upcoming|week|month)$","description":"all = ongoing + upcoming; week/month = starting within 7/30 days","default":"all","title":"When"},"description":"all = ongoing + upcoming; week/month = starting within 7/30 days"},{"name":"after","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO date/datetime: only events ending on or after this","title":"After"},"description":"ISO date/datetime: only events ending on or after this"},{"name":"before","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO date/datetime: only events starting on or before this","title":"Before"},"description":"ISO date/datetime: only events starting on or before this"},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated: luma,meetup,devpost,mlh,devfolio,unstop,ethglobal,hackerearth,eventbrite,manual","title":"Source"},"description":"Comma-separated: luma,meetup,devpost,mlh,devfolio,unstop,ethglobal,hackerearth,eventbrite,manual"},{"name":"mode","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(in-person|hybrid)$"},{"type":"null"}],"description":"Narrow to strictly in-person or hybrid","title":"Mode"},"description":"Narrow to strictly in-person or hybrid"},{"name":"theme","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Substring match on themes, e.g. ai","title":"Theme"},"description":"Substring match on themes, e.g. ai"},{"name":"min_size","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"description":"Minimum registered participants","title":"Min Size"},"description":"Minimum registered participants"},{"name":"featured","in":"query","required":false,"schema":{"type":"boolean","description":"Only editor-featured events","default":false,"title":"Featured"},"description":"Only editor-featured events"},{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(hackathon|event)$"},{"type":"null"}],"description":"hackathon = hackathons only; event = workshops, build days, meetups","title":"Kind"},"description":"hackathon = hackathons only; event = workshops, build days, meetups"},{"name":"sort","in":"query","required":false,"schema":{"type":"string","pattern":"^(soonest|biggest|deadline|newest)$","description":"biggest = most registered participants first","default":"soonest","title":"Sort"},"description":"biggest = most registered participants first"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/events/{event_id}":{"get":{"tags":["public"],"summary":"One event by id","operationId":"api_event_api_events__event_id__get","parameters":[{"name":"event_id","in":"path","required":true,"schema":{"type":"string","title":"Event Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/status":{"get":{"tags":["public"],"summary":"Data freshness and per-source health","operationId":"api_status_api_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}