{"openapi":"3.1.0","info":{"title":"Colonial Beach public discovery","version":"1.0.0"},"servers":[{"url":"https://colonialbeachapp.com"}],"paths":{"/events":{"get":{"summary":"Read public events","parameters":[{"name":"format","in":"query","required":true,"schema":{"type":"string","enum":["json"]}},{"name":"start_date","in":"query","schema":{"type":"string"}},{"name":"end_date","in":"query","schema":{"type":"string"}},{"name":"query","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer"}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Public listings and freshness","content":{"application/json":{"schema":{"type":"object","properties":{"town":{"type":"string"},"timezone":{"type":"string"},"today":{"type":"string"},"start_date":{"type":"string"},"end_date":{"type":"string"},"query":{"type":"string"},"total_matches":{"type":"integer","minimum":0},"total_matches_exact":{"type":"boolean"},"events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"date":{"type":"string"},"end_date":{"type":"string"},"title":{"type":"string"},"time":{"type":"string"},"venue":{"type":"string"},"address":{"type":"string"},"description":{"type":"string"},"link":{"type":"string"},"category":{"type":"string"},"source":{"type":"string"},"provenance":{"type":"object","properties":{"kind":{"enum":["live","published"]},"source_url":{"type":["string","null"]},"updated_at":{"type":["string","null"]}},"required":["kind","source_url","updated_at"],"additionalProperties":false}},"required":["id","url","date","title","source","provenance"],"additionalProperties":false}},"pagination":{"type":"object","properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]}},"required":["limit","offset","has_more","next_cursor"],"additionalProperties":false},"freshness":{"type":"object","properties":{"status":{"enum":["live","fallback","partial"]},"fetched_at":{"type":["string","null"]},"snapshot_built_at":{"type":["string","null"]},"upstream_truncated":{"type":"boolean"},"note":{"type":"string"}},"required":["status","fetched_at","snapshot_built_at","upstream_truncated","note"],"additionalProperties":false},"note":{"type":"string"},"more":{"type":"string"}},"required":["town","timezone","today","start_date","end_date","query","total_matches","total_matches_exact","events","pagination","freshness","more"],"additionalProperties":false}}}},"400":{"description":"Invalid filters or expired cursor"},"429":{"description":"Rate limited; respect Retry-After"}}}},"/places":{"get":{"summary":"Read public places","parameters":[{"name":"format","in":"query","required":true,"schema":{"type":"string","enum":["json"]}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"query","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer"}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Public listings and freshness","content":{"application/json":{"schema":{"type":"object","properties":{"town":{"type":"string"},"timezone":{"type":"string"},"category":{"type":"string"},"query":{"type":"string"},"total_matches":{"type":"integer","minimum":0},"total_matches_exact":{"type":"boolean"},"places":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"category":{"type":"string"},"name":{"type":"string"},"address":{"type":"string"},"phone":{"type":"string"},"website":{"type":"string"},"hours":{"type":"string"},"desc":{"type":"string"},"price":{"type":"string"},"rates":{"type":"string"},"season":{"type":"string"},"subcategory":{"type":"string"},"signature":{"type":"string"},"hours_verified":{"type":"string"},"hours_source":{"type":"string"},"menu_url":{"type":"string"},"reservation_url":{"type":"string"},"known_for":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"provenance":{"type":"object","properties":{"kind":{"enum":["live","published"]},"source_url":{"type":["string","null"]},"updated_at":{"type":["string","null"]}},"required":["kind","source_url","updated_at"],"additionalProperties":false}},"required":["id","url","category","name","provenance"],"additionalProperties":false}},"pagination":{"type":"object","properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]}},"required":["limit","offset","has_more","next_cursor"],"additionalProperties":false},"freshness":{"type":"object","properties":{"status":{"enum":["live","fallback","partial"]},"fetched_at":{"type":["string","null"]},"snapshot_built_at":{"type":["string","null"]},"upstream_truncated":{"type":"boolean"},"note":{"type":"string"}},"required":["status","fetched_at","snapshot_built_at","upstream_truncated","note"],"additionalProperties":false},"more":{"type":"string"}},"required":["town","timezone","category","query","total_matches","total_matches_exact","places","pagination","freshness","more"],"additionalProperties":false}}}},"400":{"description":"Invalid filters or expired cursor"},"429":{"description":"Rate limited; respect Retry-After"}}}},"/events/{id}":{"get":{"summary":"Read one public event","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id returned by the collection. Prefer following its url."},{"name":"format","in":"query","required":true,"schema":{"type":"string","enum":["json"]}}],"responses":{"200":{"description":"Public record with source information","content":{"application/json":{"schema":{"type":"object","properties":{"town":{"type":"string"},"timezone":{"type":"string"},"event":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"date":{"type":"string"},"end_date":{"type":"string"},"title":{"type":"string"},"time":{"type":"string"},"venue":{"type":"string"},"address":{"type":"string"},"description":{"type":"string"},"link":{"type":"string"},"category":{"type":"string"},"source":{"type":"string"},"provenance":{"type":"object","properties":{"kind":{"enum":["live","published"]},"source_url":{"type":["string","null"]},"updated_at":{"type":["string","null"]}},"required":["kind","source_url","updated_at"],"additionalProperties":false}},"required":["id","url","date","title","source","provenance"],"additionalProperties":false},"freshness":{"type":"object","properties":{"status":{"enum":["live","fallback","partial"]},"fetched_at":{"type":["string","null"]},"snapshot_built_at":{"type":["string","null"]},"upstream_truncated":{"type":"boolean"},"note":{"type":"string"}},"required":["status","fetched_at","snapshot_built_at","upstream_truncated","note"],"additionalProperties":false}},"required":["town","timezone","event","freshness"],"additionalProperties":false}}}},"404":{"description":"Record not found in the current catalog"},"429":{"description":"Rate limited; respect Retry-After"},"503":{"description":"Live source unavailable; record cannot be checked"}}}},"/places/{id}":{"get":{"summary":"Read one public place","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id returned by the collection. Prefer following its url."},{"name":"format","in":"query","required":true,"schema":{"type":"string","enum":["json"]}}],"responses":{"200":{"description":"Public record with source information","content":{"application/json":{"schema":{"type":"object","properties":{"town":{"type":"string"},"timezone":{"type":"string"},"place":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"category":{"type":"string"},"name":{"type":"string"},"address":{"type":"string"},"phone":{"type":"string"},"website":{"type":"string"},"hours":{"type":"string"},"desc":{"type":"string"},"price":{"type":"string"},"rates":{"type":"string"},"season":{"type":"string"},"subcategory":{"type":"string"},"signature":{"type":"string"},"hours_verified":{"type":"string"},"hours_source":{"type":"string"},"menu_url":{"type":"string"},"reservation_url":{"type":"string"},"known_for":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"provenance":{"type":"object","properties":{"kind":{"enum":["live","published"]},"source_url":{"type":["string","null"]},"updated_at":{"type":["string","null"]}},"required":["kind","source_url","updated_at"],"additionalProperties":false}},"required":["id","url","category","name","provenance"],"additionalProperties":false},"freshness":{"type":"object","properties":{"status":{"enum":["live","fallback","partial"]},"fetched_at":{"type":["string","null"]},"snapshot_built_at":{"type":["string","null"]},"upstream_truncated":{"type":"boolean"},"note":{"type":"string"}},"required":["status","fetched_at","snapshot_built_at","upstream_truncated","note"],"additionalProperties":false}},"required":["town","timezone","place","freshness"],"additionalProperties":false}}}},"404":{"description":"Record not found in the current catalog"},"429":{"description":"Rate limited; respect Retry-After"},"503":{"description":"Live source unavailable; record cannot be checked"}}}}}}