{"openapi":"3.1.0","info":{"title":"ICON HOTEL direct booking","version":"0.1.0","description":"Search ICON HOTEL entire-place vacation rentals in Japan, get live prices, and get a link to book on the official site. This API never books or charges; the guest pays on the booking page. Use is subject to https://iconhotel.jp/legal/ai-terms (privacy: https://iconhotel.jp/legal/privacy).","termsOfService":"https://iconhotel.jp/legal/ai-terms"},"servers":[{"url":"https://iconhotel.jp"}],"paths":{"/agent/v1/properties":{"get":{"operationId":"searchProperties","summary":"Search stays (optionally with dates for live prices)","parameters":[{"name":"area","in":"query","required":false,"schema":{"type":"string"}},{"name":"guests","in":"query","required":false,"schema":{"type":"integer","minimum":1}},{"name":"pets","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"sauna","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","enum":["en","ja","ko","zh","zht"]}},{"name":"checkin","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"checkout","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"adults","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":2}},{"name":"children","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0}},{"name":"agent","in":"query","required":false,"schema":{"type":"string"},"description":"Name of the assistant calling, e.g. chatgpt"}],"responses":{"200":{"description":"Matching properties"}}}},"/agent/v1/quote":{"get":{"operationId":"getQuote","summary":"Live total price for one property and dates, with a booking link","parameters":[{"name":"property","in":"query","required":true,"schema":{"type":"string"}},{"name":"checkin","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"checkout","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"adults","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":2}},{"name":"children","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0}},{"name":"agent","in":"query","required":false,"schema":{"type":"string"},"description":"Name of the assistant calling, e.g. chatgpt"}],"responses":{"200":{"description":"Quote"},"400":{"description":"Invalid input (e.g. below minimum stay)"}}}},"/agent/v1/booking-link":{"get":{"operationId":"createBookingLink","summary":"Booking page link with dates and guests filled in","parameters":[{"name":"property","in":"query","required":true,"schema":{"type":"string"}},{"name":"checkin","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"checkout","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"adults","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":2}},{"name":"children","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0}},{"name":"agent","in":"query","required":false,"schema":{"type":"string"},"description":"Name of the assistant calling, e.g. chatgpt"}],"responses":{"200":{"description":"Link"}}}}}}