price-watches

Watch the cheapest price for a whole destination search

Runs priceWatch.createSearchWatch. Tracks the cheapest hotel for destination and the stay, rather than one hotel. Send currentPrice (the cheapest price on screen, a stay total) when creating from live results so it becomes the baseline; targetPrice must be below it. source defaults to saved_page; native search results should send search_results. 400 for past or reversed dates, or when the account already tracks the maximum number of destinations; 409 when this destination and stay are already tracked. Returns { watch }, the same shape the destination entries of GET /v1/price-watches carry.

post/v1/price-watches/destinations

Request

  • Base URL: https://api.getmyhotels.com
  • URL: https://api.getmyhotels.com/v1/price-watches/destinations
  • Auth: HTTP bearer

Request body

destinationstring required
checkInstring date required
checkOutstring date required
roomsinteger
adultsinteger
childreninteger
currencystring required
currentPricenumber
targetPricenumber
source'chat' | 'search_results' | 'saved_page'

Response

Success

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.