{"openapi":"3.1.0","info":{"title":"Umgebinde 1657 - Agent API","description":"Live availability, exact prices and booking links for the holiday flats of Umgebinde 1657 in Krippen near Bad Schandau, Saxon Switzerland. Built for AI agents acting on behalf of guests. No key needed. Please stay below 30 requests per minute.","version":"1.0.0"},"servers":[{"url":"https://umgebinde1657.de"}],"paths":{"/api/agent/availability":{"get":{"tags":["agent"],"summary":"Live availability and exact prices","operationId":"get_availability_api_agent_availability_get","parameters":[{"name":"checkin","in":"query","required":true,"schema":{"type":"string","description":"Arrival date YYYY-MM-DD (from 16:00)","examples":["2026-11-16"],"title":"Checkin"},"description":"Arrival date YYYY-MM-DD (from 16:00)"},{"name":"checkout","in":"query","required":true,"schema":{"type":"string","description":"Departure date YYYY-MM-DD (until 10:00)","examples":["2026-11-19"],"title":"Checkout"},"description":"Departure date YYYY-MM-DD (until 10:00)"},{"name":"adults","in":"query","required":false,"schema":{"type":"integer","maximum":14,"minimum":1,"description":"Number of adults","default":2,"title":"Adults"},"description":"Number of adults"},{"name":"child_ages","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated ages of children 0-17, e.g. '5,9'","title":"Child Ages"},"description":"Comma-separated ages of children 0-17, e.g. '5,9'"},{"name":"unit","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"elbschifferhaus | steinbrecherstube | ganzes-haus","title":"Unit"},"description":"elbschifferhaus | steinbrecherstube | ganzes-haus"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agent/property":{"get":{"tags":["agent"],"summary":"Facts about the house and both flats","operationId":"get_property_api_agent_property_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/agent/reviews":{"get":{"tags":["agent"],"summary":"Guest reviews (Google) with average and count","operationId":"get_reviews_rest_api_agent_reviews_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agent/booking":{"post":{"tags":["agent"],"summary":"Book on behalf of a guest (not yet active)","operationId":"post_booking_api_agent_booking_post","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"}}}}